一条命令，解锁 Agent 全网访问能力。
刷推特、搜领英、逛社交媒体、抓网页。无需配置，装好即用。
安装 ·
支持平台 ·
常见问题 ·
English
---
**安装 AgentKey，让你的 AI 拥有超能力**
AgentKey 是 Agent 生态里的"万能钥匙"。用户在用 Claude、Manus 这些 Agent 时，经常需要获取外部数据（社交媒体、电商、链上数据、各种 API），但要么要自己找 API 填 Key，要么根本找不到解决方案。
装了 AgentKey，Agent 就自动具备了这些数据获取能力。无需逐个注册服务、逐个管理账单，一份订阅全部搞定。
> ⭐ 右上角 Star 本项目，我们会持续更新平台接入变化，有新版本自动通知你。
---
## 使用场景
| 你对 Agent 说 | 没装会怎样 | 装了 AgentKey 后 |
| ----------------------------------------------------- | ----------------------- | ---------------------------------- |
| 🐦 马斯克最近在推特上在说什么 | 看不了，搜不到完整推文 | 一次拉全相关推文，帮你总结结论 |
| 📕 Ins 上大家怎么看这个产品 | 打不开，必须登录才能看 | 直接抓真实笔记，按口碑帮你归纳 |
| 📺 这个 YouTube / B 站视频讲了什么 | 看不了，字幕拿不到 | 自动看视频/字幕，提炼要点 |
| 📖 去 Reddit 上看看有没有人遇到同样的痛点 | 403 被封，帖子进不去 | 找到相关帖子，把解法抽出来 |
| 👔 帮我看一下这家竞品 / 候选人的 LinkedIn | 进不去，权限烦还老 403 | 打开公司/个人页，提炼关键信息 |
| 🎵 帮我看看抖音 / TikTok 最近哪些话题最热 | 刷不动榜单，只能自己刷 | 抓热门话题和标签，帮你总结趋势 |
| 🌐 帮我看看这个网页写了啥 | 抓回来一堆 HTML，没法读 | 把正文抠出来，用几段话讲清楚 |
| 📦 这个 GitHub 仓库是干嘛的？ | 只能自己点进仓库慢慢翻 | 看 README、Issue，一句话说清 |
| 🧾 帮我看看这个地址/基金最近在买什么 | 自己去区块浏览器一笔笔点 | 自动汇总最近交易，帮你看仓位变化 |
没有安装之前：10 个任务，10 个 Key，10 份账单。
Agent 就像半智能体，完全无法自主行动，不断需要人类帮助搜寻解决方案，管理复杂度直线上升。
现在，一个 AgentKey，所有服务全部搞定。**AgentKey 统一了 AI 干活需要的一切外部访问。**
---
## 第一次来？先到网页上看看
在动命令行之前，你可以先在浏览器里熟悉一下 AgentKey —— 官网和后台讲得比 README 更直观。
- 🌐 **[agentkey.app](https://agentkey.app)** —— 产品介绍、支持的平台、在线演示、计费说明
- 🎛️ **[console.agentkey.app](https://console.agentkey.app)** —— 注册账号、管理订阅、管理 API Key、查看用量
下面的一条命令是把 AgentKey 接进你的 AI Agent。如果只是想先看看，上面两个链接是更友好的入口。
---
## 安装
一条命令。浏览器弹出登录，完成即可。安装脚本会自动识别你机器上每一个支持的 Agent（[已支持 40+](https://github.com/vercel-labs/skills#available-agents)，常见的如 Claude Code、Codex、Gemini CLI、Cursor CLI 等），逐个配好。
**macOS / Linux**
```bash
curl -fsSL https://agentkey.app/install.sh | bash
```
**Windows**（PowerShell）
```powershell
irm https://agentkey.app/install.ps1 | iex
```
重启 Agent，然后问它一些需要联网的问题：
> *"马斯克最近在推特上在说什么？"*
就这样。不用复制 API Key，也不用改 JSON。
想只装到特定 Agent 或在 CI 里跑？→ 看 [常见问题](#常见问题) 里的"进阶安装"条目。
---
## 装好之后能干什么
AgentKey 在云端维护与开放互联网各类平台的对接 —— 你不需要额外开账号，也不用再填 Key。
| 能力 | 覆盖范围 |
| :--- | :--- |
| **网页搜索** | 搜索引擎结果、新闻与实时信息发现 |
| **网页抓取** | 从任意 URL 提取正文、结构化数据与元信息 |
| **链上 / 加密** | 代币行情、链上活动、项目与市场元数据 |
| **社交与内容** | 主流社交、视频、问答平台的公开内容 |
| **金融** | 股票与外汇行情、技术指标、公司财务与财报 |
| **电商** | 主流电商平台的商品详情、价格、评价与热销榜 |
| **商业数据** | 公司、融资、投资人与关键人物数据，用于市场与竞品研究 |
底层 provider 由 AgentKey 自动路由并持续扩充 —— Agent 可以通过 `find_tools` 查看当前可用的接入。
**规划中：** 地图与天气
---
## 常见问题
安全吗？
安全。AgentKey 是 Agent 的"万能钥匙"—— 一个平台帮你的 Agent 解锁外部能力。按架构设计，我们看不到你的本地文件、凭证或 Agent 的对话。AgentKey 只采集匿名使用统计 —— 你装到了哪些 Agent、Skill 版本、升级结果 —— 永远不采集你的查询内容或返回数据。详见下方"我如何关闭遥测？"。
和 Claude / ChatGPT 自带的能力有什么不一样？
Claude 与 ChatGPT 的原生联网与平台覆盖有限，往往触达不到推特、链上数据等。AgentKey 让你的 Agent 能覆盖这些场景（具体以当前产品能力为准）。
怎么计费？套餐额度用完了怎么办？
AgentKey 采用订阅制。每档套餐包含每月的 credits 额度，超出部分按量计费（超额付费）。你可以随时在 [console.agentkey.app](https://console.agentkey.app) 升级套餐或管理账单。具体套餐与价格见 [agentkey.app](https://agentkey.app)。
怎么更新？
AgentKey 有两部分，更新方式不同：
- **MCP server**：真正的服务端在 `https://api.agentkey.app/v1/mcp`，永远自动最新，不需要本地升级。`@agentkey/cli` 包（`npx -y @agentkey/cli --auth-login`）只负责把远程 HTTP MCP 配置写入各个 AI client，除非要换 API Key，否则不用再跑。
- **Skill 文件**（`SKILL.md` 加辅助脚本）：升级方式取决于你用的 client。
### Claude Code
完全自动。每次会话第一次调用 skill 时会静默跑版本检查；发现新版本会提示你升级，得到你确认后跑 `npx skills update -g agentkey`。
### Claude Desktop / Cursor 等没有 inline Bash 工具的 client
Skill 自己跑不了 inline 检查，但**从 v1.4.0 起 MCP server 通过专用 metadata tool（`agentkey_skill_meta`）发布最新 skill 版本号**。Agent 在每个会话里调一次，对比本地 skill 版本，发现差异就用你 client 对应的精确命令提示你升级。协议细节见 [protocol/skill-meta-v1.md](../protocol/skill-meta-v1.md)。
**Desktop 一次性破冰升级**：如果你 Desktop 里的 skill 还停在 1.4.0 之前，metadata tool 存在但旧 skill 不懂怎么读。先手动同步一次到最新版：
```bash
# 把 / 替换成 skills-plugin 下实际的 session 目录
# （通常就一个，找包含 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
# 然后完全退出并重启 Claude Desktop。
```
破冰之后，后续每次新版都会通过 metadata tool 自动告知，无需再手动操作。
### 任意 client：强制手动更新
```bash
# 拉最新版的 Skill 内容
npx skills update agentkey
# 锁定特定版本
npx skills add chainbase-labs/agentkey@v1.0.0
```
注意：`npx skills update` 只写 `~/.agents/skills/agentkey` 和 `~/.claude/skills/agentkey` 这两个目录，是 Claude Code 读取的位置。**Claude Desktop 读的是自己的 sandbox 路径**，`npx skills update` 碰不到——Desktop 升级要用上面的破冰命令。
只有在需要换 API Key 时才需要再跑一次 `npx -y @agentkey/cli --auth-login`。
怎么卸载？
一条命令，清理所有 Agent 与配置。
**macOS / Linux**
```bash
curl -fsSL https://agentkey.app/uninstall.sh | bash
```
**Windows**（PowerShell）
```powershell
irm https://agentkey.app/uninstall.ps1 | iex
```
把 Skill 从所有 Agent 里清理掉，同时删除各 MCP 客户端里的 `agentkey` 条目 + API Key，清理缓存和日志。加 `--keep-marketplace`（bash）/ `-KeepMarketplace`（PowerShell）可以保留 Claude Code 的 marketplace 条目。
**想手动两步卸载？**
```bash
# 1. 把 Skill 从所有 Agent 里移除
npx skills remove chainbase-labs/agentkey
# 2. 在各 MCP 客户端配置里删掉 mcpServers 下的 "agentkey" 条目：
# - 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 里的 AgentKey 段、MCP stdio 日志 —— 想一次清干净就用它。
我如何关闭遥测？
AgentKey 会上报匿名使用统计（你用的 Agent、Skill 版本、升级结果 —— 永远不会上报查询内容或返回数据）。任选一种方式关闭：
```bash
# 持久关闭（推荐）
touch ~/.config/agentkey/telemetry-disabled
# 进程级临时关闭（CI / 单次会话）
AGENTKEY_TELEMETRY=0
# 安装时直接关
curl -fsSL https://agentkey.app/install.sh | bash -s -- --no-telemetry
```
想重新开启，删掉 `~/.config/agentkey/telemetry-disabled` 即可。
好像哪里不对？怎么排查？
在 Agent 里试试 `/agentkey status` —— 会诊断 MCP 配置、版本、连通性。
可用的 Slash 命令：
| 命令 | 作用 |
|---|---|
| `/agentkey` | 主入口：数据查询时自动触发，通常不需要手动调用 |
| `/agentkey setup` | 初始安装：配置 API Key + 验证 MCP 连通性 |
| `/agentkey status` | 诊断当前配置状态（MCP、版本、连通性测试） |
还是解决不了？看下面"怎么获取帮助"那条。
进阶安装（CI / 指定 Agent / 手动两步）
安装器会自动探测本机已安装的 AI Agent（依据 [vercel-labs/skills 支持列表](https://github.com/vercel-labs/skills) 比对配置目录和命令行工具），自动选中它们 —— 不再弹多选框。需要覆盖时用下面的旗标：
**安装器参数：**
```bash
# 非交互模式（CI / 无人值守）：安装到所有检测到的 Agent，不询问
curl -fsSL https://agentkey.app/install.sh | bash -s -- --yes
# 看一下安装器在本机会自动选中哪些 Agent（看完即退出）
curl -fsSL https://agentkey.app/install.sh | bash -s -- --list-agents
# 只安装到指定的 Agent（覆盖自动检测结果）
curl -fsSL https://agentkey.app/install.sh | bash -s -- --only claude-code,cursor
# 跳过我们的检测，让 skills CLI 自己识别全部 Agent
curl -fsSL https://agentkey.app/install.sh | bash -s -- --all-agents
# 只装 Skill 或只做 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. 把 Skill 装进所有检测到的 Agent
npx skills add chainbase-labs/agentkey
# 2. 浏览器授权并注册 MCP Server
npx -y @agentkey/cli --auth-login
```
**没 GUI / SSH / Docker？** 授权步骤会**同时**尝试开浏览器并把 URL 打印到终端 —— 在没法弹浏览器的机器上，直接把打印出来的 URL 复制到任何能开浏览器的设备完成授权即可。如果完全不想走 URL 跳转、想自己手动粘 Key，可以用 `npx -y @agentkey/cli --setup` 走交互式向导。
我的 Agent 没被自动配置，怎么手动设置？
MCP 自动配置覆盖 **Claude Code**、**Claude Desktop**、**Cursor**。如果你用的是 **Codex / OpenCode / Gemini CLI / Hermes / Manus**（或 Linux 版 Claude Desktop），Skill 会正常装上，但你需要把下面这段 MCP 片段手动贴到该 Agent 的配置里（路径因 Agent 而异）：
```json
{
"mcpServers": {
"agentkey": {
"type": "http",
"url": "https://api.agentkey.app/v1/mcp",
"headers": { "Authorization": "Bearer ak_..." }
}
}
}
```
写完后重启 Agent。你第一次在对话里触发 Skill 时，它也会引导你走这一步。
能自托管 / 本地开发吗？
**从本地 checkout 安装：**
```bash
git clone https://github.com/chainbase-labs/agentkey.git
cd agentkey
# 1. 把当前工作副本装进所有检测到的 Agent
npx skills add .
# 2. 注册 MCP Server（只需一次）
npx -y @agentkey/cli --auth-login
```
`npx skills add .` 支持本地路径（也支持 `file://` URL），改完 `skills/agentkey/SKILL.md` 再跑一次就能立刻生效，是日常迭代最快的路径。MCP 注册步骤每台机器只需一次。
**想改 MCP Server 本身？** MCP server 在 `AgentKey-Server/`（Go），端点是 `/v1/mcp`。本地起服务（`make run`），把 MCP 配置指向 `http://localhost:8081/v1/mcp` 就能端到端验证。
**Claude Code 插件模式** —— 直接从 marketplace 安装。插件启用时会提示你填 AgentKey API Key 并自动接好 MCP server，**不需要再单独跑 `@agentkey/cli`**：
```bash
# 公开安装
claude plugin marketplace add chainbase-labs/agentkey
claude plugin install agentkey@agentkey
# …或从本地 checkout 安装，用于开发
claude plugin marketplace add /absolute/path/to/agentkey
claude plugin install agentkey@agentkey
```
启用时 Claude Code 会提示填 `AGENTKEY_API_KEY`（存进系统钥匙串），并通过 `${user_config.AGENTKEY_API_KEY}` 注入插件的 `.mcp.json`。改了本地 checkout 后用 `claude plugin update agentkey` 重新加载。日常 Skill 迭代仍是 skills CLI 最快；插件路径是给 Claude Code 用户的一步到位选项。
**Codex 插件模式** —— 从本仓库自带的 marketplace 安装。认证走 OAuth（安装时浏览器登录），**不用粘贴 API Key，也不需要再单独跑 `@agentkey/cli`**：
```bash
# 公开安装
codex plugin marketplace add chainbase-labs/agentkey
# 然后在 Codex 里运行 /plugins 安装 AgentKey，
# 或者：codex plugin install agentkey@agentkey
```
插件清单在 `.codex-plugin/plugin.json`；它捆绑了同一个 Skill，外加一条远程 HTTP MCP 配置（`.codex-plugin/mcp.json`），通过 MCP OAuth（RFC 9728 自动发现）对 `https://api.agentkey.app/v1/mcp` 做认证。Codex 提示时用你的 AgentKey 账号登录即可。
**Kimi Code 插件模式** —— 直接在 Kimi Code 中安装本仓库。插件清单同时捆绑 Skill 和内联的远程 HTTP MCP 配置，**不用粘贴 API Key，也不需要再单独跑 `@agentkey/cli`**：
```text
# 公开安装
/plugins install https://github.com/chainbase-labs/agentkey
# 或从本地 checkout 安装，用于开发
/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 plugin 手工通过 `/mcp-config` 添加过用户全局的 `agentkey` 条目，请在 reload 前执行一次 `/mcp-config remove agentkey` 删除旧条目。现在 plugin 会维护自己的命名空间 MCP；同时保留两份会造成工具和鉴权流程重复。
**Cursor 插件模式** —— 插件上架后，从 Cursor Marketplace 安装 AgentKey。`.cursor-plugin/plugin.json` 这个 Cursor 原生清单会同时捆绑同一个 Skill 和内联的远程 HTTP MCP 配置，因此**不用粘贴 API Key，也不需要再单独运行 `@agentkey/cli`**。Cursor 提示 MCP 需要认证时，在浏览器完成 AgentKey 登录即可。
维护者需要先把插件推送到公开 Git 仓库，再到 [cursor.com/marketplace/publish](https://cursor.com/marketplace/publish) 提交仓库地址。提交前请使用当前版本 Cursor 实际安装测试，确认 OAuth 完成后 `agentkey` Skill 和 MCP server 都能正常加载。清单遵循 [Cursor 插件参考](https://cursor.com/cn/docs/reference/plugins)，其中所有组件路径都必须相对于插件根目录。
**Gemini CLI 扩展模式** —— 把本仓库直接安装为 extension。根目录的 `gemini-extension.json` 会捆绑现有 AgentKey skill 和远程 Streamable HTTP MCP server，**不用粘贴 API Key，也不需要再单独跑 `@agentkey/cli`**：
```bash
# 公开安装
gemini extensions install https://github.com/chainbase-labs/agentkey
# 或链接本地 checkout，用于开发
gemini extensions link /absolute/path/to/agentkey
```
安装或链接后重启 Gemini CLI。如果 MCP server 提示需要认证，执行 `/mcp auth agentkey` 并在浏览器完成授权；之后 Gemini 会保存并自动刷新 OAuth token。修改 server 配置后可执行 `/mcp reload`。
**Antigravity 2.0 / Antigravity CLI 插件模式** —— 两个运行时共用根目录的 `plugin.json`、`mcp_config.json` 和现有 `skills/`。MCP 配置使用 Antigravity 规定的 `serverUrl` 并依赖自动 OAuth discovery，**不用粘贴 API Key，也不需要再单独运行 `@agentkey/cli`**。
Antigravity 2.0 可按 workspace 或全局范围放置插件，完成后重启 Antigravity：
```bash
# Workspace 范围
git clone https://github.com/chainbase-labs/agentkey.git /path/to/workspace/.agents/plugins/agentkey
# 或全局范围
git clone https://github.com/chainbase-labs/agentkey.git ~/.gemini/config/plugins/agentkey
```
Antigravity CLI 使用本地 checkout 安装并确认注册结果：
```bash
agy plugin install /absolute/path/to/agentkey
agy plugin list
```
Antigravity 2.0 在 **Settings → Customizations → Authenticate** 中完成 OAuth。Antigravity CLI 首次连接时按认证提示操作；需要检查状态或重新加载 server 时打开 `/mcp`。
**仓库结构：**
```
agentkey/
├── .claude-plugin/plugin.json # Claude Code 插件清单
├── .codex-plugin/
│ ├── plugin.json # Codex 插件清单
│ └── mcp.json # Codex MCP 配置（OAuth，无 user_config）
├── .cursor-plugin/
│ └── plugin.json # Cursor 清单，捆绑 Skill 与内联 MCP OAuth
├── .kimi-plugin/
│ └── plugin.json # Kimi 清单，内联 MCP OAuth 配置
├── .agents/plugins/marketplace.json # Codex marketplace（本仓库即自己的 marketplace）
├── .mcp.json # 作为 Claude Code 插件安装时使用
├── gemini-extension.json # Gemini CLI 扩展清单（MCP OAuth + skills）
├── plugin.json # Antigravity 桌面端/CLI 插件清单
├── mcp_config.json # Antigravity 远程 MCP 配置（serverUrl + OAuth）
├── skills/agentkey/
│ ├── SKILL.md # 决策树 & 路由规则
│ ├── scripts/ # check-update 辅助脚本
│ └── version.txt # 由 release-please 自动维护
└── scripts/
├── install.sh # 一键安装脚本（mac/linux）
├── install.ps1 # Windows PowerShell 安装脚本
├── uninstall.sh # 一键卸载脚本（mac/linux）
└── uninstall.ps1 # Windows PowerShell 卸载脚本
```
**发布新版本（Maintainer）：** 发版由 [release-please](https://github.com/googleapis/release-please) 自动触发。合并一个 `feat:` 或 `fix:` 的 PR 后，release-please 会开一个 Release PR，自动 bump `skills/agentkey/version.txt`、四个带版本号的插件清单、`gemini-extension.json` 和 `CHANGELOG.md`。Antigravity schema 没有 `version` 字段，因此根目录 `plugin.json` 不参与版本同步。合并这个 Release PR 即会创建 tag + GitHub Release + 上传 `agentkey.skill` 产物。
目前产品是什么阶段？
早期内测阶段，产品仍有不少不完善之处，还请担待。功能建议与问题反馈欢迎通过 [GitHub Issues](https://github.com/chainbase-labs/agentkey/issues) 或下面的 Telegram 与我们联系。
怎么获取帮助 / 反馈 bug / 关注更新？
- **Telegram：** [t.me/AgentKey_Official](https://t.me/AgentKey_Official) —— 通用咨询、支持、需求反馈
- **问题反馈：** [GitHub Issues](https://github.com/chainbase-labs/agentkey/issues)
- **发布公告：** ⭐ Star 本项目即可在有新版本时收到通知
---
## Star 历史
[](https://www.star-history.com/?repos=chainbase-labs%2Fagentkey&type=date&legend=top-left)