一条命令,让你的 AI 智能体拥有完整互联网访问能力。
66.5/100
综合分
659
GitHub 星标
—
npm 周下载
—/5
用户评分
数据截至 2026/9/16 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。
自动兼容检查未通过:缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装。以下命令仍可尝试,但可能失败。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add chainbase-labs/Agentkey该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)
状态速览
判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态信任档位:已验证
是什么
dsh 原生插件 · search
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
更新放缓:最近一次提交在 70 天前
档位由哪些信号合成
本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查需源码安装缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装
展开查看检查明细 ↓
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。
✗npm 包agentkey-skill(未发布到 npm,仅可源码安装)
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明
源码安装时若 pnpm 拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。
验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/29 09:38:57
安全扫描自动 · 静态分析源码v2.7.0⚪ 扫描:无法判定尚无人工评估展开查看扫描说明与证据 ↓
安全扫描自动 · 静态分析源码
v2.7.0已尝试扫描但取不到可分析的源码:仓库或包不存在、已删除,或为非 JS/TS 实现、未随包发布源码。无法判定,不代表安全。
- · 包内无可扫 JS
- · TS 源码(可能为非 JS 实现或未发布源码),无法判定
扫描于 2026/11/3(0 天前) · 范围 全包扫描(包内未声明入口) · 来源 GitHub 仓库
静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。
给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个
功能亮点
- 网页搜索
- 社交媒体数据访问
- 加密与链上数据
把你的 AI 智能体连到全世界——网页搜索、社交媒体、加密与链上数据。一个插件,零额外配置。
README
由 DeepSeek 最新模型翻译生成一条命令,让你的 AI 智能体拥有完整互联网访问能力。
刷 Twitter、搜 LinkedIn、抓取社交媒体、读取任意网页。零配置,装上就能用。
安装 ·平台 ·常见问题 ·
安装 AgentKey,给你的 AI 装上超能力。
AgentKey 是智能体生态的万能钥匙。用 Claude、Manus 或其他智能体时,你经常需要外部数据:社交媒体、电商、链上数据、各种 API。这意味着你得四处找 API key、管理订阅,或者干脆撞上死路。
装上 AgentKey,你的智能体自动获得这些数据能力。不用逐个服务商注册,不用来回切换多份 API 账单。一份订阅,直接开跑。
⭐ 给这个仓库点个 Star,我们新增平台支持或发布更新时你就能收到通知。
使用场景
| 你让智能体去做…… | 没有 AgentKey | 有 AgentKey |
| 🐦 马斯克最近在 Twitter 上说了什么? | 访问不了,推文被屏蔽 | 拉取相关推文并总结 |
| 📕 Instagram 上大家怎么评价这款产品? | 被屏蔽,需要登录 | 抓取真实帖子,按情绪归类 |
| 📺 这个 YouTube / Bilibili 视频讲了什么?
展开完整文档(README 剩余 1 节)
一条命令,让你的 AI 智能体拥有完整互联网访问能力。
刷 Twitter、搜 LinkedIn、抓取社交媒体、读取任意网页。零配置,装上就能用。
安装 ·平台 ·常见问题 ·
安装 AgentKey,给你的 AI 装上超能力。
AgentKey 是智能体生态的万能钥匙。用 Claude、Manus 或其他智能体时,你经常需要外部数据:社交媒体、电商、链上数据、各种 API。这意味着你得四处找 API key、管理订阅,或者干脆撞上死路。
装上 AgentKey,你的智能体自动获得这些数据能力。不用逐个服务商注册,不用来回切换多份 API 账单。一份订阅,直接开跑。
⭐ 给这个仓库点个 Star,我们新增平台支持或发布更新时你就能收到通知。
使用场景
| 你让智能体去做…… | 没有 AgentKey | 有 AgentKey |
| 🐦 马斯克最近在 Twitter 上说了什么? | 访问不了,推文被屏蔽 | 拉取相关推文并总结 |
| 📕 Instagram 上大家怎么评价这款产品? | 被屏蔽,需要登录 | 抓取真实帖子,按情绪归类 |
| 📺 这个 YouTube / Bilibili 视频讲了什么? | 读不了,没有字幕 | 读取视频/字幕,提取要点 |
| 📖 找找 Reddit 上关于这个痛点的讨论帖 | 403 被屏蔽 | 找到相关帖子并提取解决方案 |
| 👔 查一下这个竞品 / 候选人的 LinkedIn | 403,访问受限 | 打开页面,总结关键信息 |
| 🎵 抖音 / TikTok 现在什么最火? | 抓不到热搜榜 | 拉取热门话题和标签 |
| 🌐 这个网页说了什么? | 返回一堵原始 HTML 的墙 | 提取内容,讲清楚 |
| 📦 这个 GitHub 仓库是做什么的? | 得自己一个个点进去看 | 读 README 和 Issues,一句话总结 |
| 🧾 这个钱包 / 基金最近在买什么? | 在区块浏览器里翻来翻去 | 汇总近期交易和持仓 |
用 AgentKey 之前:10 个任务 → 10 个 API key → 10 份独立账单。
你的智能体顶多算半吊子,找数据要人帮忙,凭据管理一团乱,复杂度快把人淹了。
现在:一个 AgentKey 全搞定。AgentKey 统一了 AI 干实事所需的所有外部访问。
第一次来?先从网页开始
还没碰终端之前,你可以直接在浏览器里感受 AgentKey —— 网站和控制台比这份 README 讲得更直观。
- 🌐 agentkey.app —— 产品概览、支持的平台、在线演示、价格详情
- 🎛️ console.agentkey.app —— 注册、管理订阅、管理 API key、查看用量
下面这条一行安装命令,才是把 AgentKey 接进你 AI 智能体的那一步。如果你只想先逛逛,上面两个链接是更友好的起点。
安装
一条命令。浏览器标签页打开登录,然后就完事了。安装器会自动检测你机器上的每个智能体(支持 40+ 种,常见的有 Claude Code、Codex、Gemini CLI、Cursor CLI 等),并逐个完成配置。
macOS / Linux
curl -fsSL https://agentkey.app/install.sh | bash
Windows(PowerShell) irm https://agentkey.app/install.ps1 | iex
重启你的智能体,然后问它一个需要联网的问题。正在运行的 DeepSeek Harness 配置档会通过 HMR 监听 home patch;已停止的配置档会在下次启动时加载。
「马斯克最近在推特上聊什么?」
就这样。不用复制 API key,不用编辑 JSON。
需要指定特定智能体,或者要在 CI 里跑?→ 看 FAQ 里的「Advanced install options」条目。
DeepSeek Harness(DSH)
上面的一行安装脚本会自动检测 ${DSH_HOME:-~/.dsh} 或 dsh 命令。它们把 AgentKey 技能全局安装到 ~/.agents/skills/agentkey,用 AgentKey 完成认证,并向 DSH 的 home 级 patch 添加一个受管理的 Loader 块:
${DSH_HOME:-~/.dsh}/cordis.patch.yml
这是由命令行管理的 DSH MCP 集成,不是可直接安装的 DSH 原生插件。home 层使用 Loader id agentkey、模块 @deepseek-ai/dsh-mcp-client,以及 MCP serverName: agentkey;它会组合到当前和未来的配置档之上。工具允许/拒绝策略仍然决定预设、会话或子代理能否看到这些工具。
DSH 0.1.0-rc.7 不会向它的 MCP SDK 客户端提供 OAuth authProvider。不带 header 的服务器条目无法完成 401/RFC 9728 发现,也无法打开浏览器。DSH 必须使用下面的设备码命令,让命令行写入本地 Bearer key。
如果只想给 DSH 手动安装,严格按这两步执行:
npx -y skills add chainbase-labs/agentkey -g -a universal -s agentkey -y
npx -y @agentkey/cli --auth-login --only dsh
命令行只把真正的 API key 存进本地唯一的 home 补丁;任何 key 都不该进 Git。重新运行命令会轮换 key,并替换受管区块。不需要已有配置档。迁移期间,它只从各配置档补丁里删除顶层、第 1 列的 AgentKey 受管区块,并把遗留的 .agent-presets/agentkey 目录重命名为带时间戳的备份;命令行会打印该备份路径。如果它从结构上检测到更早的、未标记的 AgentKey Loader 行,就会停下,不改动任何补丁,并要求你手动删除那个顶层 insert 子节点。符号链接的配置档补丁只做只读检查:干净的符号链接配置档允许通过,而两种遗留 AgentKey 形式都会中止安装,并报告路径供你手动删除。
只有当前正在运行的配置档进程会通过 HMR 立即感知 home 文件变化。已停止和未来的配置档在启动时加载它。如果某个旧预设已在会话中激活,迁移后关闭该会话,或重启一次 DSH。
如何确认 DSH 安装
1. 打开 DSH → Settings → Plugins → Plugin list,搜索配置 id agentkey,展开 mcp-client 行。DSH 0.1 目前显示:
- Loader path:include:agentkey(稳定的配置条目 id 是 agentkey)
- module title:@deepseek-ai/dsh-mcp-client(卡片会简写为 mcp-client)
- Cordis status:Mounted(底层 fiber 阶段是 active)
Mounted/active 只能证明 Cordis 加载了该行。因为 failOnStartupError: false,它不能证明 MCP 已完成认证或连接。
2. 在目标预设/会话中,确认三个核心工具可见:
- mcp__agentkey__find_tools
- mcp__agentkey__describe_tool
- mcp__agentkey__execute_tool
list_tools 已废弃,不是就绪条件。如果某个核心工具只在某个上下文里被隐藏,检查该预设/会话/子代理的工具策略。
3. 提问:“Please use AgentKey to search for today's latest AI news.” 成功需要真正调用 find_tools → describe_tool → execute_tool,而不只是看到 Mounted 卡片。
故障排查:
- 没有 agentkey 行: 主目录补丁没写入,或者 DSH_HOME 指向了别处。重新运行 DSH-only 命令行命令,检查它报告的路径。
- 行存在,但没 Mounted/active: 检查 Loader 报错,确认 DSH 安装里存在 @deepseek-ai/dsh-mcp-client。
- 已 Mounted,但工具缺失: 检查 MCP 连接日志、本地 Authorization key 和当前生效的工具策略。在 tools/list 里,每个工具的根 inputSchema.additionalProperties 必须缺失或为 true,绝不能是 false。
- 401: 本地 key 缺失或无效;重新运行 auth-login 轮换它。
- serverName already in use: 重新运行当前命令行,让它归档旧预设,然后关闭仍持有旧预设的会话,或者重启 DSH 一次。
你的智能体现在能做什么
AgentKey 在开放网络上维护云端集成 —— 不用额外账号,不用额外 key。
| 能力 | 覆盖范围 |
| 网页搜索 | 搜索引擎、新闻,以及开放网络上的实时发现 |
| 网页抓取 | 从任意 URL 干净地提取文章、结构化数据和元数据 |
| 链上 / 加密货币 | token 价格、市场数据、链上活动和项目元数据 |
| 社交与内容 | 各大社交与内容平台上的公开帖子、视频和讨论 |
| 金融 | 股票与外汇行情、技术指标、公司财务和财报 |
| 电商 | 各大电商平台上的商品列表、价格、评论和畅销榜 |
| 商业 | 公司、融资、投资人和人员数据,用于市场与竞争调研 |
底层服务商自动路由,并且会不断增加 —— 你的智能体可以调用 find_tools 查看当前可用的能力。
规划中: 地图与天气
常见问题
安全吗?
安全。AgentKey 是一把主钥匙 —— 一个平台,为你的智能体解锁外部能力。按设计,我们无法访问你的本地文件、你的凭据,也无法访问你的智能体对话。AgentKey 收集的唯一数据是匿名使用遥测 —— 你装进了哪个智能体、你的技能版本、升级结果 —— 绝不收集你的查询或回复。参见下文「如何退出遥测?」。
这和 Claude / ChatGPT 内置的网页访问有什么不同?
Claude 和 ChatGPT 的原生网页访问平台覆盖有限。它常常够不到 Twitter、链上数据等。AgentKey 填补这些空白。
定价怎么算?套餐额度用完了怎么办?
AgentKey 按订阅制。每个套餐包含每月额度;超出部分按量计费,作为超额费用。你可以随时在 console.agentkey.app 升级套餐或管理账单。当前套餐与价格见 agentkey.app。
怎么更新?
有两部分,更新方式不一样:
- MCP 服务器:真正的服务器托管在 https://api.agentkey.app/v1/mcp,所以它永远是最新的——本地不需要升级。@agentkey/cli 包(用 npx -y @agentkey/cli --auth-login 运行)只负责把远程 HTTP 的 MCP 配置写进各个 AI 客户端,除非你想轮换密钥,否则不用重新运行。
- 技能文件(SKILL.md + 辅助文件):怎么更新取决于你的客户端。
Claude Code
自动更新。会话第一次调用时,技能会静默跑一次版本检查;如果有新版本,它会提示你升级,并在你同意后运行 npx skills update -g agentkey。
Claude Desktop、Cursor 以及其他没有内联 Bash 工具的客户端
技能自己没法跑内联检查,但从 v1.4.0 起,MCP 服务器会通过一个专门的元数据工具(agentkey_skill_meta)发布最新的技能版本。你的智能体每个会话调用它一次,跟当前技能自己的版本比对,然后提示你用对应客户端的准确命令升级。协议细节见 protocol/skill-meta-v1.md。
Desktop 上的一次性引导: 如果你的 Claude Desktop 还卡在 1.4.0 之前的技能上,元数据工具已经存在,但你的技能规则不知道怎么读它。用下面这段把自己更新一次:
Replace <UUID1>/<UUID2> with the actual session folder under skills-plugin
(usually there's just one; pick the one that contains skills/agentkey/SKILL.md)
DESKTOP_BASE="$HOME/Library/Application Support/Claude/local-agent-mode-sessions/skills-plugin"
LATEST_REPO_ZIP=$(mktemp -d)/agentkey.tar.gz
curl -fsSL https://github.com/chainbase-labs/agentkey/archive/refs/heads/main.tar.gz -o "$LATEST_REPO_ZIP"
tar -xzf "$LATEST_REPO_ZIP" -C "$(dirname "$LATEST_REPO_ZIP")"
find "$DESKTOP_BASE" -type d -path "*/skills/agentkey" 2>/dev/null | while read -r dst; do
cp -R "$(dirname "$LATEST_REPO_ZIP")"/agentkey-main/skills/agentkey/. "$dst/"
done
Then fully quit and restart Claude Desktop.
做完这一次引导之后,以后的版本都会通过元数据工具自动发现。
强制手动更新(任何客户端)
Refresh the skill content
npx skills update agentkey
Pin a specific version
npx skills add chainbase-labs/agentkey@v1.0.0
注意:npx skills update 会写入 ~/.agents/skills/agentkey 和 ~/.claude/skills/agentkey,Claude Code 就是从这两个位置读取的。Claude Desktop 读的是它自己的沙箱路径,npx skills update 碰不到——Desktop 请用上面的 Desktop 引导命令。
只有想轮换 API key 时,才需要重新运行 npx -y @agentkey/cli --auth-login。
怎么卸载?
一条命令,清理所有智能体和配置文件。
macOS / Linux
curl -fsSL https://agentkey.app/uninstall.sh | bash
Windows(PowerShell) irm https://agentkey.app/uninstall.ps1 | iex
从所有智能体中移除技能,从所有 MCP 客户端配置中删掉 agentkey MCP 条目和 API key,并清理缓存与日志。传入 --keep-marketplace(bash)/ -KeepMarketplace(PowerShell)可保留 Claude Code 插件市场条目。
更想手动分两步走?
1. Remove the skill from every agent
npx skills remove chainbase-labs/agentkey
2. Delete the "agentkey" entry under mcpServers in each MCP client config:
- Claude Code: ~/.claude.json
- Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
%APPDATA%\Claude\claude_desktop_config.json (Windows)
- Cursor: ~/.cursor/mcp.json
一条命令的卸载脚本还会额外清理 npm/npx 缓存、遗留的 shell rc 条目、CLAUDE.md 片段以及 MCP stdio 日志——想要彻底清干净就用它。
怎么退出遥测?
AgentKey 会发送匿名使用遥测(你用的是哪个智能体、技能版本、升级结果——绝不包含查询或响应内容)。三种退出方式,任选一种即可:
Persistent opt-out (recommended)
touch ~/.config/agentkey/telemetry-disabled
One-shot env override (CI / single session)
AGENTKEY_TELEMETRY=0 <your command>
At install time
curl -fsSL https://agentkey.app/install.sh | bash -s -- --no-telemetry
想重新开启,删掉 ~/.config/agentkey/telemetry-disabled 即可。
有东西不工作了——怎么排查?
在你的智能体里试试 /agentkey status——它会诊断你的 MCP 配置、版本和连通性。
可用的斜杠命令:
| 命令 | 作用 |
| /agentkey | 数据查询时自动触发——通常不用手动调用 |
| /agentkey setup | 首次设置:配置 API key + 验证 MCP 连通性 |
| /agentkey status | 诊断当前配置(MCP、版本、连通性测试) |
还是卡住?看下面「去哪里求助」那一条。
高级安装选项(CI / 指定智能体 / 手动分两步)
安装脚本会自动检测你机器上有哪些 AI 智能体(通过探测 vercel-labs/skills supported-agents list 中已知的配置目录和二进制文件),并预先选中它们——不会弹出多选提示。用下面的参数可以覆盖。
安装脚本参数:
Non-interactive (CI / unattended): install to every detected agent, no prompts
curl -fsSL https://agentkey.app/install.sh | bash -s -- --yes
See which agents the installer would auto-select on this host (and exit)
curl -fsSL https://agentkey.app/install.sh | bash -s -- --list-agents
Only install the skill for specific agents (overrides auto-detection)bash
curl -fsSL https://agentkey.app/install.sh | bash -s -- --only claude-code,cursor
跳过我们的智能体检测;让 skills CLI 为它找到的每个智能体都装上
curl -fsSL https://agentkey.app/install.sh | bash -s -- --all-agents
只装技能,或只做 MCP 认证
curl -fsSL https://agentkey.app/install.sh | bash -s -- --skip-mcp
curl -fsSL https://agentkey.app/install.sh | bash -s -- --skip-skill
PowerShell 对应参数:-Yes、-ListAgents、-Only、-AllAgents、-SkipMcp、-SkipSkill。
手动两步安装(如果你想自己跑底下这两条命令,或者一行安装脚本连不上你的机器): bash
1. Install the skill into every detected agent
npx skills add chainbase-labs/agentkey
2. Authenticate and register the MCP server
npx -y @agentkey/cli --auth-login
无头环境 / SSH / Docker? 认证这一步总会尝试打开浏览器,同时把 URL 打印出来——所以在没有可用显示器的机器上,直接把打印出来的 URL 复制到任意有浏览器的设备上,就能完成认证。想手动输入密钥?npx -y @agentkey/cli --setup 会打开交互式向导。
我的智能体不在自动配置列表里,怎么手动配置?
CLI 支持当前 Supported agents 列表里列出的客户端,一行安装脚本会针对它检测到的受支持客户端下手——其中就包括 DeepSeek Harness。如果你的客户端没被检测到,或者不支持自动配置,技能仍然可以全局安装,但你必须把下面这段 MCP 配置粘贴到那个客户端自己的配置里(路径因客户端而异): json {
"mcpServers": {
"agentkey": {
"type": "http",
"url": "https://api.agentkey.app/v1/mcp",
"headers": { "Authorization": "Bearer ak_..." }
}
}
}
然后重启智能体。技能首次运行时的激活流程也会带你走一遍。
我能自托管,或者基于它做开发吗?
从本地检出安装: bash
git clone https://github.com/chainbase-labs/agentkey.git
cd agentkey
1. Install your working tree into every detected agent
npx skills add .
2. Register the MCP server (if you haven't already)
npx -y @agentkey/cli --auth-login
npx skills add . 接受本地路径(或 file:// URL)——每次改完 skills/agentkey/SKILL.md 就再跑一次。MCP 这一步每台机器只需要跑一次。
想改 MCP 服务器本身? 服务器在 AgentKey-Server/(Go),MCP 端点是 /v1/mcp。跑一个本地服务器(make run),把 MCP 配置指向 http://localhost:8081/v1/mcp,就能端到端测试改动。
Claude Code 插件模式——直接从市场安装。插件打包了一个免 header 的远程 HTTP 入口,走 Claude Code 原生 MCP OAuth 流程,所以不用粘贴 API key,也不用再跑一次 @agentkey/cli: bash
Public install
claude plugin marketplace add chainbase-labs/agentkey
claude plugin install agentkey@agentkey
…or from a local checkout, for development claude plugin marketplace add /absolute/path/to/agentkey claude plugin install agentkey@agentkey
安装完成后,运行 /reload-plugins,打开 /mcp,选中 AgentKey 条目,然后选择 Authenticate 完成浏览器登录。在终端里,claude mcp login plugin:agentkey:agentkey 会启动同样的 OAuth 流程。插件的 .mcp.json 故意不带 Authorization 头:一旦加上,Claude Code 就会把这个服务器当成头部认证,401 之后不再回退到 OAuth。改完本地 checkout 后,用 claude plugin update agentkey 重新加载。日常迭代技能,走 Skills CLI 这条路仍然最快;插件这条路是给 Claude Code 用户准备的 OAuth 方案。
Codex 插件模式 —— 从本仓库内置的 marketplace 安装。认证走 OAuth(安装时浏览器登录),所以不用粘贴 API key,也不需要第二步 @agentkey/cli:
Public install
codex plugin marketplace add chainbase-labs/agentkey
then run /plugins inside Codex and install AgentKey,
or: codex plugin install agentkey@agentkey
插件清单放在 .codex-plugin/plugin.json;它打包了同一个技能,外加一条 remote-HTTP MCP 条目(.codex-plugin/mcp.json),通过 MCP OAuth(RFC 9728 发现)向 https://api.agentkey.app/v1/mcp 认证。Codex 提示登录时,用你的 AgentKey 账号登录即可。
Kimi Code 插件模式 —— 直接从 Kimi Code 安装本仓库。清单打包了技能,并内联了一条 remote-HTTP MCP 条目,走客户端归属的 https://api.agentkey.app/kimi/v1/mcp 路由,所以不用粘贴 API key,也不需要第二步 @agentkey/cli:
Public install
/plugins install https://github.com/chainbase-labs/agentkey
Or install a local checkout for development
/plugins install /absolute/path/to/agentkey
安装后 Kimi 会显示 Run /new or /reload to apply plugin changes.。运行 /reload;当 Kimi 提示插件 MCP 服务器需要 OAuth 时,运行 /mcp-config login plugin-agentkey:agentkey,在浏览器里批准授权。之后你就可以接着问原来那个 AgentKey 问题。
Kimi 会把本地插件复制到它管理的插件目录。改完 checkout 后,重新运行 /plugins install /absolute/path/to/agentkey,然后再运行一次 /reload。
如果你之前为了绕过旧版 AgentKey 插件,通过 /mcp-config 加过用户全局的 agentkey 条目,重新加载前先用 /mcp-config remove agentkey 删掉它。现在这个命名空间下的 MCP 条目归插件所有;两个都留着会产生重复工具和重复的认证尝试。
Cursor 插件模式 —— 等上架之后,从 Cursor Marketplace 安装 AgentKey。Cursor 原生清单放在 .cursor-plugin/plugin.json,里面打包了同一个技能,还有一条内联的 remote-HTTP MCP 条目,所以不用粘贴 API key,也不用再跑一遍 @agentkey/cli。Cursor 弹出 MCP 认证提示时,批准 AgentKey 的浏览器登录即可。
维护者要把插件推到公开 Git 仓库,然后在 cursor.com/marketplace/publish 提交仓库 URL。提交之前,先在当前 Cursor 版本里测试插件,确认 OAuth 之后 agentkey 技能和 MCP 服务器都能正常加载。清单遵循 Cursor plugin reference;组件路径保持相对于插件根目录。
Gemini CLI 扩展模式 —— 把仓库作为扩展安装。根目录的 gemini-extension.json 打包了现有的 AgentKey 技能和远程 Streamable HTTP MCP 服务器,所以不用粘贴 API key,也不用再跑一遍 @agentkey/cli:
Public install
gemini extensions install https://github.com/chainbase-labs/agentkey
Or link a local checkout for development
gemini extensions link /absolute/path/to/agentkey
安装或链接之后重启 Gemini CLI。首次连接时,扩展的 oauth.enabled 设置会让 Gemini 自动启动原生浏览器授权。走完这个流程,然后运行 /mcp reload 和 /mcp list,确认 agentkey 已连接。如果 Gemini 只提示需要认证,或者浏览器流程被关掉了,运行 /mcp auth agentkey 手动启动。Gemini 会存储并刷新 OAuth token,所以通常只需登录一次。扩展模式下不要再加一条用户级 MCP 条目,也不要运行 @agentkey/cli --auth-login。
如果 Gemini 提示 ~/.agents/skills/agentkey 覆盖了扩展打包的那份,这是技能优先级警告,不是 OAuth 失败。之前安装的用户技能优先级更高,只要版本相同就可以安全保留——尤其是其他智能体也在用这个共享目录时。只有别处不再需要它时,才用 gemini skills uninstall agentkey --scope user 删除,然后运行 /skills reload。
Antigravity 2.0 / Antigravity CLI 插件模式 —— 两个运行时都用根目录的 plugin.json、mcp_config.json 和现有的 skills/ 目录。MCP 条目使用 Antigravity 的 serverUrl schema,并通过动态客户端注册自动发现 OAuth,所以不用粘贴 API key,不用配置 OAuth client secret,也不用再跑一遍 @agentkey/cli。
Antigravity 2.0 要把仓库放在工作区范围或全局范围,然后重启 Antigravity:
Workspace scope
git clone https://github.com/chainbase-labs/agentkey.git /path/to/workspace/.agents/plugins/agentkey
Or global scopebash
git clone https://github.com/chainbase-labs/agentkey.git ~/.gemini/config/plugins/agentkey
Antigravity 命令行要安装本地检出并确认已注册: bash agy plugin install /absolute/path/to/agentkey agy plugin list
Antigravity 发现插件后,直接认证它自带的 MCP 条目,不要再添加一份重复的:
- Antigravity 2.0: 打开 Settings → Customizations → Installed MCP Servers,点 AgentKey 旁边的 Authenticate,走完浏览器流程,把授权码复制回设置面板并提交。服务器会自动重连;状态没更新就点 Refresh。
- Antigravity 命令行: 打开 /mcp,选 agentkey,点 Authenticate,按浏览器和验证码提示操作。在同一个面板里重新加载服务器,确认 AgentKey 工具已列出;如果仍然断开,就在那里查看连接日志。
mcp_config.json 里不要放静态请求头、访问 token 和 OAuth 客户端凭据。AgentKey 会发布受保护资源和授权服务器元数据,其中包含动态注册端点,供两种 Antigravity 运行时发现。
仓库结构:
agentkey/
├── .claude-plugin/plugin.json # Claude Code plugin manifest
├── .codex-plugin/
│ ├── plugin.json # Codex plugin manifest
│ └── mcp.json # Codex MCP entry (OAuth, no user_config)
├── .cursor-plugin/
│ └── plugin.json # Cursor manifest with Skill + inline MCP OAuth
├── .kimi-plugin/
│ └── plugin.json # Kimi manifest with inline MCP OAuth entry
├── .agents/plugins/marketplace.json # Codex marketplace (this repo is its own marketplace)
├── .mcp.json # Claude plugin MCP entry (OAuth discovery, no headers)
├── gemini-extension.json # Gemini CLI extension manifest (MCP OAuth + skills)
├── plugin.json # Antigravity desktop/CLI plugin manifest
├── mcp_config.json # Antigravity remote MCP entry (serverUrl + OAuth)
├── skills/agentkey/
│ ├── SKILL.md # Decision tree + routing rules
│ ├── scripts/ # check-update helper
│ └── version.txt # Managed by release-please
└── scripts/
├── build-release-assets.sh # Build Skill + Gemini GitHub Release assets
├── install.sh # One-command installer (mac/linux)
├── install.ps1 # Windows PowerShell installer
├── uninstall.sh # One-command uninstaller (mac/linux)
└── uninstall.ps1 # Windows PowerShell uninstaller
发布新版本(维护者): 版本由 release-please 自动发布。合并标题带 feat: 或 fix: 的 PR,会打开一个 Release PR,更新 skills/agentkey/version.txt、四个带版本号的插件清单、gemini-extension.json 和 CHANGELOG.md。Antigravity schema 没有 version 字段,所以它的根 plugin.json 不参与版本同步。合并 Release PR 会创建 tag + GitHub Release,保留 agentkey.skill 资产,并上传以平台命名的 Gemini 扩展归档,其根目录包含 gemini-extension.json。
产品目前处于什么阶段?
早期访问。还有一些粗糙的地方,感谢你的耐心。欢迎通过 GitHub Issues 或 Telegram(见下文)提交功能请求和 bug 报告。
在哪里获取帮助 / 报告 bug / 关注更新?
- Telegram: t.me/AgentKey_Official — 一般问题、支持、功能请求
- Bug reports: GitHub Issues
- Release announcements: ⭐ star this repo to get notified
Star History预览分享卡片长什么样 ↓
分享 · DeepSeek Harness Hub
chainbase-labs/Agentkey
一条命令,让你的 AI 智能体拥有完整互联网访问能力。
相关插件 · 搜索 / 抓取
LLM 知识平台Tencent/WeKnora
概览 ·快速开始 ·新特性 ·功能 ·客户端 ·文档 ·开发
★ 36,266已汉化DSH
72
智能体记忆系统MemTensor/MemOS
MemOS 2.0 Stardust星尘
★ 12,228已汉化DSH
71.3
跨代理记忆库zilliztech/memsearch
跨平台语义记忆,专为 AI 编程智能体打造。
★ 2,799已汉化DSH
70.9
跨智能体会话记忆vshulcz/deja-vu
你的编码智能体不再重复调试你已经修好的问题。
★ 1,367已汉化MCP
70.4
技能语料库EverMind-AI/SkillCorpus
SkillCorpus 能给你什么
★ 694已汉化DSH
69.7
动画花园资源检索yjl9903/AnimeGarden
按番剧、字幕组和类型搜索动画 BT 资源
★ 1,391已汉化DSH
69.2