AgentKey 接口调查笔记（详细版）
调查对象：https://agentkey.app（文档：docs.agentkey.app） 调查日期：2026-07-18 结论先行：AgentKey 是一个 统一 MCP 网关，用「一把 key + 一个余额」把 ~1800 个第三方数据接口聚合起来，卖给 AI Agent（Claude Code / Gemini CLI 等）。它对外只暴露 4 个元工具 + 动态发现，1800 个具体工具藏在后面按需检索。
可信度标注：文中「已确认」= 文档里明写或给了样例；数量统计（~1800/1169/347…）= 文档自述统计（二手可信）；底层 API 对应关系除已确认的 7 家（Brave/Twitter/Chainbase/Firecrawl/Jina/BrightData/Crunchbase）外，均为基于覆盖范围与命名风格的推断；各接口的"能拿什么数据"是文档描述 + 对这些平台真实 API 的常识补全，非逐个工具实测。
#一、它到底是什么
- 定位：一个 MCP Server，装一次就能让任意 AI Agent 调用搜索 / 抓取 / 社交 / 加密 / 金融 / 电商 / 商业数据。
- 计费：按量付费，一个余额充值、按调用扣 credit，典型一次查询几美分；带月订阅额度 + 超量续费。
- 两大卖点：One Unified Key（一把主 key 打通所有上游，不用各家单独注册）+ Auto Failover（上游宕机自动切备用 provider，会话不中断）。
#二、核心架构：真正对外的只有 4 个接口
工作流 Discover → Describe → Execute，工具命名规则 Provider/Operation：
| 元工具 | 作用 |
|---|---|
account |
查剩余 credit + 上游健康状态，永久免费 |
find_tools |
用自然语言意图发现该用哪个工具 |
describe_tool |
拿某工具的参数、单次价格、可执行模板 |
execute_tool |
按 Provider/Operation 执行（如 Twitter/searchTweets） |
#三、各分类下的接口作用（详细）
#1. 搜索（Search，6 家）
把不同搜索引擎/答案引擎统一成"搜索"能力。这一类解决的是 Agent 的信息检索入口问题——同一个"搜索"意图，可以根据需要走不同引擎（要新鲜度走 Serper、要语义走 Exa、要直接答案走 Perplexity）。每家 provider 通常拆出 web / news / image / LLM-context 几种 operation。
Brave — 底层 Brave Search API。独立自建的搜索索引（不是转发 Google/Bing），主打隐私、结果不被大厂算法污染。
Brave/getWebSearch（已确认）：网页综合搜索，返回标题 / 链接 / 摘要。Brave/getNewsSearch（已确认）：新闻搜索，可按时间过滤，适合追热点。Brave/getImageSearch（已确认）：图片搜索，返回图片 URL + 来源页。- Agent 用途：需要一个"干净、独立、有隐私"的基础搜索源时的首选；因为是自有索引，抗封锁、稳定性好。
Tavily — 底层 Tavily API。专为 LLM/RAG 设计的搜索：不只给链接，还直接抽取并总结每个结果的正文要点，返回结构化、已去噪的内容，Agent 可以直接喂进上下文而不用再二次抓取。
- Agent 用途：做 RAG、需要"搜完直接能用"的场景；省掉"搜索→逐个打开→提正文"这几步。
Serper — 底层 Serper.dev。本质是 Google 搜索结果页（SERP）的抓取代理，返回最接近真实 Google 的排序、People-Also-Ask、知识面板等。
- Agent 用途：需要"Google 眼里这个词排第一的是谁"、做 SEO/竞品/舆情分析时用；胜在结果权威、贴近真实用户看到的。
Perplexity — 底层 Perplexity Sonar 模型。答案引擎而非搜索引擎：输入一个问题，直接返回一段带引用来源的自然语言答案（背后已经帮你搜+读+总结）。
- Agent 用途：需要"直接要结论"而不是自己处理一堆链接时用；相当于内置了一个会上网的小模型。
Parallel — 底层 Parallel.ai。面向 Agent 的搜索 API，主打给自动化智能体做深度、多轮检索任务（不是给人用的单次搜索），能处理更复杂的检索目标。
- Agent 用途：需要"帮我把这个课题查透"这种多步研究型检索时用。
Exa — 底层 Exa（原 Metaphor）。神经网络语义搜索：按"意思/意图"匹配而非关键词，还能一并把命中页面的正文取回（contents）。擅长"找和这个类似的东西""找符合某种描述的页面"。
- Agent 用途：探索性检索、找相似内容、按语义找冷门优质页面；关键词搜不出来的用它。
六家怎么选：要独立干净基础搜索→Brave；要搜完直接能用→Tavily；要 Google 真实排序→Serper；要直接答案→Perplexity；要多步深度研究→Parallel；要语义/找相似→Exa。AgentKey 的价值是这六个背后共用一把 key、还能自动 failover。
#2. 抓取（Scrape，3 家）
解决"把任意 URL 变成 LLM 能读的干净内容，并绕过反爬"。搜索是"找到链接"，抓取是"把链接里的内容取回来变成 Markdown"。三家覆盖从"温和转换"到"硬刚反爬"的不同强度。
Firecrawl — 底层 Firecrawl API。最主流的"网页转 Markdown"服务，会渲染 JS、去广告去导航，输出干净正文。
Firecrawl/scrape（已确认）：单页 → 干净 Markdown。- 另有
crawl：整站爬取（顺着链接把整个站抓下来）；map：先出站点地图（列出一个域名下所有可抓 URL），再挑着抓。 - Agent 用途：需要把一篇文章/一个文档站/一个博客变成上下文时用；整站知识入库首选。
Jina — 底层 Jina Reader。轻量快速的"URL→Markdown"，就是在地址前拼
r.jina.ai/。Jina Reader/readUrlGet、readUrlPost（已确认）：GET/POST 两种方式把 URL 转成 Markdown。- 还有搜索能力（
s.jina.ai）：搜索 + 直接返回结果正文。 - Agent 用途：要"快、便宜、单页"时用；比 Firecrawl 轻，适合高频零散抓取。
Bright Data — 底层 Bright Data。最硬的一档：靠住宅代理池打反爬，能过 Cloudflare / 验证码 / 登录墙那类挡爬的页面。
BrightData/unlock（已确认）：Web Unlocker，绕过反爬挑战后返回原始 HTML（不帮你转 Markdown，交给你自己解析）。- Agent 用途：前两家被封、被 403、被人机验证挡住时的"重武器"；成本更高但能取到别人取不到的页面。
#3. 社交媒体（Social，23 个 → 约 1169 个工具，数量最多的一类）
每个平台都不是"一个接口"，而是一整套 operation，通常覆盖这几类能力：
- 内容检索：按关键词/话题搜帖子、视频、笔记；
- 用户维度：查某个账号的资料、粉丝数、关注、主页作品列表；
- 互动维度：拉某条内容的评论、点赞、转发；
- 趋势维度：热榜、热搜、趋势话题、上升视频。
已确认样例：Twitter/searchTweets（拉最新公开推文）。下面逐平台说清"能拿什么、典型用来干嘛"：
| 平台 | 接口作用（能拿什么数据 + 典型用途） |
|---|---|
| X/Twitter | 搜推文、看某账号资料/粉丝/关注、拉某条推的回复与转发、看趋势榜。用途：舆情监控、KOL 追踪、事件实时追热点。 |
| 按 subreddit 拉帖子、热榜、某帖的评论树、搜索。用途：找真实用户讨论、产品口碑、海外社区情绪（英文舆情金矿）。 | |
| YouTube | 搜视频、查频道信息与订阅数、拉视频评论、看某频道视频列表。用途：竞品内容分析、找达人、视频选题调研。 |
| 查人物职业资料、公司主页、招聘/动态信号。用途：B2B 获客、背景调查、公司组织与招聘趋势分析。 | |
| TikTok | 搜短视频、查创作者、拉评论、看话题下内容。用途：海外短视频选题、达人筛选、爆款拆解。 |
| Douyin（抖音） | 中国短视频趋势、按账号拉作品、评论、热点。用途：国内内容运营、竞品视频监控、爆款趋势。 |
| Zhihu（知乎） | 问答内容、专家高赞回答、话题下讨论。用途：找专业观点、行业深度内容、长尾问题挖掘。 |
| Bilibili（B站） | 视频信息、UP主数据、评论、分区热门。用途：二次元/年轻向内容分析、UP主合作筛选。 |
| Threads | 实时对话、帖子流。用途：Meta 系实时舆论、和 X 交叉验证话题热度。 |
| Pipixia（皮皮虾） | 社区搞笑/短视频内容。用途：下沉娱乐内容、meme 素材挖掘。 |
| WeChat（微信） | 公众号文章内容。用途：国内深度长文/行业稿采集（微信生态相对封闭，这是稀缺数据）。 |
| Lemon8 | 生活方式图文帖子。用途：字节海外种草社区的选题与趋势。 |
| Weibo（微博） | 热搜榜、话题、帖子、评论。用途：国内实时舆情/热点/明星事件的第一现场。 |
| 账号资料、图文/Reels 帖子、粉丝互动。用途：网红营销、品牌视觉调研、海外种草。 | |
| Red Book（小红书） | 笔记内容、好物点评、话题。用途：国内种草/消费趋势/女性向选题的核心数据源。 |
| Kuaishou（快手） | 创作者视频、直播信息。用途：下沉市场内容与达人、直播电商分析。 |
| 主页、公开帖子。用途：海外品牌/本地商家动态、社群舆论。 | |
| 图钉、视觉搜索、画板。用途：设计灵感、视觉趋势、电商选品图。 | |
| Discord | 社区频道消息。用途：Web3/游戏/开发者社群实时动态与情绪。 |
| Telegram | 频道/群组内容。用途：加密圈、匿名社群、信息流监控。 |
| Snapchat | 公开快拍、资料。用途：年轻向海外内容、地域快拍趋势。 |
| Twitch | 直播、频道信息。用途：游戏主播生态、直播热度分析。 |
| Product Hunt | 新品发布、讨论、投票。用途：追踪每天上线的新产品、创业与工具趋势。 |
推断（非官方确认）：中国系平台（抖音/小红书/微博/B站/知乎/快手/皮皮虾/微信/Lemon8）几乎可以肯定底层是 TikHub.io 这类逆向爬虫聚合商；欧美平台（IG/FB/TikTok/LinkedIn 等）多半走 Apify actor 或专用采集商。因为这些平台官方都不提供公开数据 API，实际打的是它们 App/Web 的私有内部接口（要签名 + Cookie + 风控绕过）。电商工具名
search-item-list_v1的风格也和 TikHub 一致，佐证了这一点。这也是 AgentKey 真正的价值所在——难的从来不是"知道要打哪个接口"，而是签名算法、风控对抗、IP 池维护，这些它替你扛了。
#4. 金融（Finance，5 家 → 约 347 个工具）
数量意外地多，因为把每一个技术指标、每一类数据都拆成了独立 operation（比如 RSI、MACD、布林带各自是一个工具）。覆盖从中国 A 股到美国宏观到全球外汇。
- Tushare — 底层 Tushare Pro。中国 A 股专用：日线/分钟行情、财务三表、基本面（PE/PB/市值）、股东、分红、指数成分等。用途：国内量化、选股、财报分析。
- Yahoo Finance — 底层 Yahoo 非官方接口。全球市场：股票/ETF/指数行情、历史 K 线、公司新闻、基本财务。用途：跨市场行情速查、美股/港股数据、新闻联动。
- FRED — 底层圣路易斯联储 FRED。美国宏观经济时间序列：利率、CPI、失业率、GDP、货币供应等几十万条官方序列。用途：宏观研究、大类资产判断、经济周期分析。
- Finnhub — 底层 Finnhub API。市场数据 + 公司披露：实时报价、财报、SEC filing、内部人交易、分析师评级。用途：美股基本面 + 事件驱动分析。
- Alpha Vantage — 底层 Alpha Vantage。行情 + 技术指标大全：股票/外汇/加密行情 + 上百种技术指标（RSI/MACD/KDJ…每个一个工具）。用途：技术分析、量化信号、外汇数据。
五家分工：中国股票→Tushare；全球行情+新闻→Yahoo；宏观经济→FRED；美股基本面+披露→Finnhub；技术指标+外汇→Alpha Vantage。
#5. 电商（E-commerce，7 个平台）
统一成三类标准 operation（已确认命名）：
search-item-list_v1：商品搜索（按关键词出商品列表）；get-item-detail_v1/get-product-detail_v1：商品详情（价格、规格、图片、评价、销量）；get-best-sellers_v1：畅销/排行榜。
| 平台 | 接口作用（能拿什么） |
|---|---|
| Taobao（淘宝） | 商品搜索、SKU 价格、评价、店铺信息。用途：比价、选品、评价情感分析。 |
| JD.COM（京东） | 商品 + 实时价格、促销、规格。用途：3C/家电比价、价格监控。 |
| Amazon | 商品详情 + 排行榜/BSR。底层多为 Rainforest API 类。用途：跨境选品、Listing 分析、竞品监控。 |
| 1688 | 批发商品列表、起订量、批发价。用途：供应链找货源、成本核算、铺货选品。 |
| Douyin E-commerce（抖音小店） | 抖音店铺商品目录、带货商品。用途：直播/短视频带货选品、达人商品分析。 |
| TikTok Shop | 社交电商商品。用途：海外直播电商选品、跨境爆款监控。 |
| Beike（贝壳） | 房产房源列表（挂牌价、户型、小区）。用途：房价监控、区域行情、房产数据分析。 |
#6. 加密货币（Crypto，14 类 → 约 179 个工具）
按功能切分成 14 个子领域，从"看币价"到"读链上原始数据"全覆盖。已确认样例：Chainbase/GetAccountBalance（查链上钱包余额，底层 Chainbase）。
| 类别 | 接口作用（能拿什么） | 可能的底层 API |
|---|---|---|
| 市场数据 | 各币实时价格、市值、涨跌幅、成交量、历史 K 线 | CoinGecko / CoinMarketCap |
| 中心化交易所 & 衍生品 | 各交易所现货/合约行情、深度、资金费率、持仓量 | Binance 等所 API |
| DEX 资金池 | 去中心化交易所池子的实时报价、流动性、交易对 | GeckoTerminal / DexScreener |
| 代币分析 | 某代币的持有者分布、集中度、转账活跃度、风险信号 | Chainbase / Moralis / Bitquery |
| NFT | 合集信息、地板价、成交、稀有度、持有者 | OpenSea / Reservoir |
| 钱包 | 某地址的余额、代币持仓、交易历史（Chainbase/GetAccountBalance） |
Chainbase / Alchemy / Moralis |
| 链上原语 | 区块、交易、Gas 价格、直接发 RPC 调用（读合约） | Alchemy / Infura |
| 域名服务 | ENS 等：地址↔域名互相解析 | ENS |
| 加密新闻 | 加密行业文章、按币种/关键词搜新闻 | CryptoPanic |
| 行业活动 | 大会、黑客松、活动日程 | 自建 / 聚合 |
| 社交情报 | 项目的社媒热度、叙事、市场情绪打分 | LunarCrush / Santiment |
| 预测市场 | 事件合约、赔率、下注量（谁在赌什么） | Polymarket |
| 项目与基金 | 协议 TVL、融资、基金持仓、协议指标 | DefiLlama / CryptoRank |
| 加密搜索 | 跨以上数据源的统一搜索入口 | 自建聚合 |
一句话：这 14 类把一个加密分析师需要的数据面铺满了——行情看盘（市场数据/CEX/DEX）、链上尽调（代币分析/钱包/链上原语）、情绪面（社交情报/新闻/预测市场）、基本面（项目与基金/NFT）。
#7. 商业数据（Business，1 家 → 约 96 个工具）
- Crunchbase — 底层 Crunchbase API。公司与投融资情报库：公司档案、融资轮次、投资人、收购、创始团队、地址、竞品。
- 已确认 operation：
getAcquisition（查收购事件）、getAddress（公司地址）、autocomplete（实体名自动补全）等，约 96 个操作把一家公司的各个维度拆开查。 - 用途：尽职调查、竞品/赛道研究、找投资标的、B2B 线索、创投趋势分析。
- 已确认 operation：
#四、一句话总结
- 对 Agent 而言，真正要请求的接口只有 4 个：
find_tools（找）、describe_tool（看用法和价格）、execute_tool（执行Provider/Operation）、account（查余额）。 - 对数据而言，AgentKey 把 60+ 家平台重新包装：
- 有官方 API 的（搜索 / 金融 / YouTube / Reddit / X / Crunchbase / 加密行情）→ 直接转发官方端点，它做统一鉴权 + failover。
- 没有官方 API 的（几乎所有社交 + 中国电商）→ 靠 TikHub / Apify 这类逆向爬虫聚合商，打平台自家 App/Web 私有接口，核心价值在于替你扛下签名、风控、IP 池。
可信度再提醒：数量统计为文档自述；已确认底层为 Brave / Twitter / Chainbase / Firecrawl / Jina / BrightData / Crunchbase 七家；其余底层对应与各接口"能拿什么数据"为推断 + 常识补全。要 100% 确认某工具真实上游，对它调
describe_tool看返回即可。
来源：沉淀/02-AI与API/AgentKey接口调查.md（整理于 2026-08-18）