关于 Scavio
Scavio 为 AI Agent 提供网页搜索、页面提取和结构化数据,覆盖搜索、电商、社交、旅行、招聘等来源。其 MCP 服务支持选择要加载的平台工具,可连接托管端点或本地运行。
主要功能
- 01跨平台网页搜索
- 02以 Markdown、文本或 HTML 提取页面
- 03映射、爬取和批量提取网站
- 04获取电商与社交平台结构化数据
- 05选择要加载的平台工具
适用场景
- 01在电商网站查找商品
- 02收集并分析社交媒体数据
- 03提取网页或网站内容
- 04搜索招聘、旅行或房地产信息
MCP 相关
向 MCP 客户端提供搜索、提取和平台专用数据工具。可通过托管 HTTP 端点连接,或在本地以 stdio 运行;托管访问支持 OAuth 或 API 密钥。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.scavio.dev/mcpclaude mcp add --transport http scavio https://mcp.scavio.dev/mcp{"mcpServers":{"scavio":{"type":"http","url":"https://mcp.scavio.dev/mcp"}}}在 Cursor 中打开{"servers":{"scavio":{"type":"http","url":"https://mcp.scavio.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"scavio":{"type":"http","url":"https://mcp.scavio.dev/mcp"}}}{"mcpServers":{"scavio":{"serverUrl":"https://mcp.scavio.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
106| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 是 | 要读取的页面。仅支持 http(s);如 'example.com' 这样的裸主机名会升级为 https。内部、环回和专用网络主机将被拒绝并返回 400。 |
| format | enum | 否 | 输出格式。'markdown' = 提取主要内容(默认,最适合阅读)。'text' = 将该 Markdown 展平为纯文本。'html' = 未经处理的原始页面。html | markdown | text |
| mode | enum | 否 | 决定价格的参数。'normal' = 普通抓取,1 个 credit(默认)。'advanced' = 对不渲染就没有内容的页面进行完整 JavaScript 渲染,1 个 credit。'ultra' = 用于应对严格机器人拦截的住宅代理,2 个 credits。仅当较便宜的模式返回空内容或被拦截时才升级。normal | advanced | ultra |
详细介绍
Scavio MCP 服务
Scavio 是统一的 Web Search API 和 MCP 服务,为 AI Agent 提供网页搜索、页面提取,以及来自电商、社交、旅游、招聘、房地产、应用商店、广告库和公司备案等来源的结构化数据。它提供涵盖 40 个平台的 272 个工具,以及提取、地图、爬取和批处理功能,只需一个 API 密钥。
0.13.0 中新增的 22 个平台需选择启用。 注册全部 272 个工具,会在你输入任何内容之前,就将约 260KB 的工具定义(约 65k 个令牌)加载到每个会话中。因此,默认配置沿用 0.12.x 已有的平台集合,并添加 Extract:共 142 个工具,112KB。升级不会移除你正在使用的任何工具。其他工具只需设置一个环境变量即可启用:请参阅选择要加载的工具。
远程 MCP 服务
无需本地安装,直接连接 Scavio 的远程 MCP 服务:
https://mcp.scavio.dev/mcp
有两种身份验证方式:
- 使用 OAuth 登录,无需复制密钥。 Claude Desktop、claude.ai 和 Claude Code 可通过服务登录你的 Scavio 账户。在 Claude Desktop 或 claude.ai 中:依次选择 Settings > Connectors > Add custom connector,将其命名为 Scavio,粘贴 URL,然后点击 Connect 和 Authorize。在 Claude Code 中:运行
claude mcp add --transport http scavio https://mcp.scavio.dev/mcp,然后运行/mcp并选择 Authenticate。 - API 密钥。 在
x-api-key请求头中传入密钥。在 scavio.dev 获取密钥。
本地运行(npx)
想在自己的机器上运行服务?使用 npx,无需克隆或构建。服务通过 stdio 运行,只需要你的 SCAVIO_API_KEY。
Claude Code
claude mcp add scavio -e SCAVIO_API_KEY=YOUR_SCAVIO_API_KEY -- npx -y @scavio/mcp-server
任何兼容 MCP 的客户端(Claude Desktop、Cursor、Windsurf、VS Code 等)
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "@scavio/mcp-server"],
"env": {
"SCAVIO_API_KEY": "YOUR_SCAVIO_API_KEY"
}
}
}
}
需要 Node.js 20+。在 scavio.dev 获取 API 密钥。
安装
Claude Code
使用 OAuth 登录,然后在 Claude Code 中运行 /mcp 并选择 Authenticate:
claude mcp add --transport http scavio https://mcp.scavio.dev/mcp
或者传入 API 密钥:
claude mcp add --transport http scavio https://mcp.scavio.dev/mcp --header "x-api-key: YOUR_SCAVIO_API_KEY"
Claude Desktop
无需 API 密钥:依次选择 Settings > Connectors > Add custom connector,将其命名为 Scavio,粘贴 https://mcp.scavio.dev/mcp,然后点击 Connect 并登录你的 Scavio 账户。claude.ai 也可按相同步骤操作。
或者在本地运行服务。添加到 claude_desktop_config.json(macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json,Windows 上为 %APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "@scavio/mcp-server"],
"env": {
"SCAVIO_API_KEY": "YOUR_SCAVIO_API_KEY"
}
}
}
}
需要 Node.js 20+。保存后重启 Claude Desktop。
Cursor
或者添加到项目根目录下的 .cursor/mcp.json,或用于全局配置的 ~/.cursor/mcp.json:
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
Windsurf
添加到 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
VS Code
在项目根目录下创建 .vscode/mcp.json:
{
"servers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
ChatGPT
- 前往 ChatGPT > Settings > Apps & Connectors
- 点击 Add custom connector
- 输入 MCP 服务 URL:
https://mcp.scavio.dev/mcp - 使用你的 API 密钥配置身份验证
Cline
添加到 cline_mcp_settings.json(通过 Cline 侧边栏 > MCP Servers > Configure 打开):
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
Zed
添加到设置中(Cmd+,):
{
"assistant": {
"mcp_servers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
}
任何兼容 MCP 的客户端
{
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
选择要加载的工具
Scavio 提供 272 个工具。全部加载会占用约 260KB 的 tools/list,也就是每个会话在用户发言前就要消耗约 64k 个上下文令牌,而且工具数量可能超过某些客户端的接受上限。因此,服务默认注册经过筛选的子集,并允许你选择其余工具。下方数据为实测值,而非估算值:运行 npm run toolslist 即可复现。
SCAVIO_PLATFORMS 是以逗号分隔的平台键允许列表:
| 值 | 注册内容 |
|---|---|
(未设置) 或 default | 0.12.x 中的所有平台,再加上 extract — 142 个工具,112KB |
all | 所有平台 — 272 个工具,约 260KB |
extract,sec,g2 | 仅这些平台 — 18 个工具,21KB |
default,zillow,metaads | 默认集合再加两个平台 — 148 个工具,120KB |
default,chatgpt,gemini | 默认集合再加 ChatGPT 和 Gemini — 144 个工具,115KB |
none | 不注册任何平台工具,仅注册 get_usage |
匹配键时不区分大小写和标点,因此 meta-ads、metaads 和 META_ADS 都表示同一平台,而 twitter 会解析为 x。未知键会记录到 stderr 并跳过,不会导致服务启动失败。
get_usage 始终会注册——它不收费,而且每份安装指南都会指导你调用它来检查服务是否正常运行。
平台键: extract、google、chatgpt、gemini、youtube、tiktok、instagram、
reddit、x、linkedin、threads、kuaishou、amazon、walmart、ebay、
target、homedepot、costco、heb、kroger、mercadolibre、tiktok-shop、booking、airbnb、
tripadvisor、yelp、zillow、redfin、realtor、rightmove、indeed、glassdoor、
appstore、googleplay、g2、capterra、trustpilot、googleads、metaads、sec、companieshouse
本地(stdio)
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "@scavio/mcp-server"],
"env": {
"SCAVIO_API_KEY": "YOUR_SCAVIO_API_KEY",
"SCAVIO_PLATFORMS": "extract,google,zillow,redfin"
}
}
}
}
远程(HTTP)
托管服务无法读取环境变量,因此请在每次连接时传入允许列表—— 可以使用标头或查询参数:
{
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY",
"x-scavio-platforms": "extract,google,sec,companieshouse"
}
}
}
https://mcp.scavio.dev/mcp?platforms=all
从 0.12.x 升级
无需操作。默认集合与 0.12.x 注册的 10 个平台完全相同,另外还包含 Extract——你此前使用的所有工具仍会加载。这些平台还会不断增加工具(Walmart 从 2 个增加到 7 个;TikTok、YouTube、Reddit 和 X 在 0.20.0 中新增了 19 个;Extract 在 0.21.0 中新增了 map、crawl 和 batch;Instagram 在 0.22.0 中新增了 8 个;Google 在 0.23.0 中新增了 google_custom_search),因此默认工具数量现在为 142 个。
0.13.0 中新增的 22 个平台需要选择加入。以追加方式添加:
SCAVIO_PLATFORMS=default,zillow,redfin,sec
有一项值得注意的破坏性修复:search_walmart 之前每次调用都会发送
fulfillment_speed: "anytime",但 API 会拒绝该值。
现在该参数只能是 today 或 tomorrow,且没有默认值。
可用工具
除非相应章节另有说明,每次调用每个工具都会消耗 1 个额度。部分
平台按端点计价(YouTube、Instagram、LinkedIn、Kuaishou),或按
请求正文计价(Extract、Threads、Walmart);get_amazon_options 和 get_usage
免费。
提取
| 工具 | 描述 |
|---|---|
extract_url | 读取任意网页,并以干净的 Markdown、纯文本或原始 HTML 返回 |
map_website | 根据网站地图和起始页面列出网站的页面 URL,可按路径筛选;已知时附带 lastmod |
crawl_website | 从一个 URL 开始抓取网站并提取所有同站页面;最多等待 wait_seconds,然后返回结果或任务 ID |
get_crawl_status | 查看抓取任务的状态、页面数量、已用额度和页面结果;可通过游标分页,也可等待任务完成 |
cancel_crawl | 停止正在运行的抓取;不会再产生费用,已获取的结果仍可读取 |
batch_extract | 在一个任务中提取一组 URL,并按输入顺序返回结果;最多等待 wait_seconds |
get_batch_status | 查看批量任务的状态和结果;可通过游标分页,也可等待任务完成 |
cancel_batch | 停止正在运行的批量任务 |
Extract 按 mode 参数分档计费,而非统一定价:normal(默认)和 advanced(渲染 JavaScript)各需 1 个额度,ultra(适用于最难处理的页面)需 2 个额度。请从 normal 开始,仅在内容为空或遭到拦截时升级。只有成功提取才会收费——失效链接、机器人拦截页或超时均不收费。没有分页:一次调用即可返回整个页面。
网站地图、抓取和批量提取(0.21.0 新增)是多页面操作:
- 定价。
map_website需 1 个额度。抓取和批量提取按成功页面计费,价格采用 Extract 对应档位的定价(normal 1 个、advanced 1 个、ultra 2 个额度);失败和跳过的页面不收费,状态查询和取消调用免费。额度逐页扣除;余额不足时,任务会正常停止,并返回stopped_reason: "insufficient_credits"。 - 套餐限制(每次抓取的最大页面数/活动任务数/每批 URL 数):Free 10 / 1 / 10,PAYG 100 / 1 / 50,Project 500 / 2 / 100,Bootstrap 2,000 / 3 / 500,Startup 5,000 / 5 / 1,000,Growth 10,000 / 10 / 1,000。超过活动任务数限制启动任务时,会返回 429 错误并列出正在运行的任务。
- 行为。 网站地图和抓取始终遵守 Robots.txt。抓取不会离开起始 URL 所在的网站(可选包含子域名),并优先访问起始路径下的页面。结果保留 3 天;任务最长运行 6 小时。
- 专为工具调用时限设计。 MCP 客户端通常会在约 60 秒后取消工具调用,因此抓取采用任务模式,而非一次漫长的调用。
crawl_website/batch_extract会启动任务并最多等待wait_seconds(默认值为 30,最大值为 50):小型任务会在完成后返回第一页结果;大型任务会返回任务 ID(如果设置了webhook_url,还会返回webhook_secret,且仅显示一次)。get_crawl_status/get_batch_status使用相同的wait_seconds进行长轮询,并使用cursor分页。 - 保持输出精简。 状态调用默认每次返回 10 条结果(
limit最大为 100),并将每个页面的内容截断至max_content_chars(默认值为 4,000);截断的页面会在完整的content_length旁标注content_clipped: true。未设置limit时,map_website会请求 200 个链接(API 默认值为 1,000)。所有还有更多内容可读取的响应都会附带_hint,其中注明确切的下一步调用。使用相同的idempotency_key重复启动调用时,会返回原任务,而不会创建第二个任务。
Google Search API
| 工具 | 描述 |
|---|---|
search_google | 网页搜索(v2),包含自然搜索结果、广告和 AI 概览 |
google_custom_search | 采用 Custom Search JSON API 格式的 Google 搜索结果(items[]、searchInformation、queries.nextPage),适用于从 CSE 迁移的代码 |
google_ai_mode | AI Mode 对话式回答,并附有引用来源 |
google_maps_search | 在 Google Maps 中搜索本地商家 |
google_maps_place | 地点详情:地址、电话、营业时间、评分 |
google_maps_reviews | 地点评价,支持分页 |
google_shopping | 商品列表,包含价格、商店和评分 |
google_shopping_product | 商品详情和卖家 |
google_shopping_stores | 查看商品的更多卖家(分页) |
google_flights | 航班行程,包含价格和经停信息 |
google_hotels | 酒店搜索,包含价格和评分 |
google_hotels_detail | 酒店详情 |
google_news | 按查询词、主题、报道或出版物搜索新闻 |
google_trends | 随时间变化的关注度和相关查询 |
google_trending | 热门搜索 |
ChatGPT and Gemini
| 工具 | 描述 |
|---|---|
chatgpt_prompt | 向 ChatGPT 提问:获取完整的 Markdown 答案、所有引用页面(标题、发布者、日期)、执行过的网页搜索以及推荐的产品 |
gemini_prompt | 向 Google Gemini 提问:获取完整的 Markdown 答案、引用的 URL 以及推荐的产品 |
用于 AI 可见度和品牌监测:询问买家可能会提出的问题(“适合小型代理机构的最佳 CRM”),查看是否推荐了某个品牌、有哪些竞争对手,以及答案引用了哪些页面。这两个工具返回相同的结构(answer.markdown、sources[]、search_queries[]、shopping[]),因此只需一个解析器即可比较不同助手。每次调用都会生成全新的答案,耗时 10-40 秒。ChatGPT 每个已回答的提示词收费 2 个积分,Gemini 收费 5 个积分;失败的提示词免费。
选择启用:将 chatgpt 和 gemini 添加到 SCAVIO_PLATFORMS(例如 default,chatgpt,gemini)。
文档:ChatGPT,
Gemini。
YouTube Data API
| 工具 | 描述 |
|---|---|
search_youtube | 搜索视频、频道和播放列表 |
search_youtube_shorts | 搜索短视频 |
youtube_search_suggestions | 获取搜索自动补全建议 |
get_youtube_video | 获取完整的视频详情、章节和字幕 |
get_youtube_metadata | get_youtube_video 的弃用别名 |
get_youtube_comments | 分页获取视频评论 |
get_youtube_comment_replies | 获取特定评论的回复 |
get_youtube_transcript | 获取纯文本或 SRT 格式的视频文字稿 |
get_youtube_related | 获取与某个视频相关的视频 |
search_youtube_channels | 按关键词搜索频道 |
get_youtube_channel | 按 ID、句柄或 URL 获取频道资料 |
get_youtube_channel_videos | 列出频道的视频 |
get_youtube_channel_shorts | 列出频道的 Shorts |
get_youtube_channel_community | 列出频道的社区帖子 |
resolve_youtube_channel | 将句柄或 URL 解析为频道 ID |
get_youtube_streams | 获取视频的直接媒体流 URL |
get_youtube_community_post | 获取一条社区帖子:文本、作者、点赞数、图片、评论游标 |
get_youtube_community_post_comments | 分页获取社区帖子的评论 |
积分消耗因工具而异:get_youtube_transcript 消耗 5 积分,get_youtube_streams 消耗 3 积分,
search_youtube 和 search_youtube_shorts 消耗 2 积分,其余 YouTube 工具各消耗 1 积分。
get_youtube_related 接受游标,但不会返回游标,因此应将其视为单页结果。
Amazon Product API
| 工具 | 描述 |
|---|---|
search_amazon | 搜索 22 个市场中的商品列表(不支持排序选项) |
get_amazon_product | 按 ASIN 获取完整商品详情 |
get_amazon_offers | 列出提供某个 ASIN 商品的所有卖家,并标出购物车赢家 |
get_amazon_options | 列出支持的市场及其国家代码(免费) |
Walmart API
| 工具 | 描述 |
|---|---|
search_walmart | 按价格和配送条件筛选商品列表 |
get_walmart_product | 按商品 ID 获取完整商品详情 |
get_walmart_reviews | 客户评价,包含评分、文本、作者、日期和评分分布 |
get_walmart_category | 获取某个类别中的商品,商品结构与搜索结果相同 |
get_walmart_offers | 商品的购物车首选报价:价格、卖家、商品状况、购物车首选标记 |
get_walmart_seller | Marketplace 卖家店铺:名称、评分、Pro Seller 徽章、企业详情 |
get_walmart_seller_products | 卖家的商品目录;total_count 表示实际数量 |
get_walmart_stores | 查找美国 ZIP 码或加拿大邮政编码附近的门店,按距离从近到远排列,并包含 store_id、地址、距离和营业时间 |
Walmart 的费用按请求正文计费,而非统一费率:com(美国,默认)
和 ca 收费 1 个点数,com.mx 收费 2 个点数。只有 search_walmart 和
get_walmart_category 支持所有 domain。
门店定位:在 search_walmart 或 get_walmart_product 中同时传入
delivery_zip 和 store_id,即可获取某家门店的商品范围和库存情况。请从同一域名(walmart.com 或
walmart.ca)的 get_walmart_stores 结果中获取 store_id。定位到门店的调用收费 2 个点数,耗时 10-60 秒,并会在 data.location 中回显所用门店。get_walmart_product 仅在与门店参数配对时才接受
domain: "ca"。
需要注意两种结果结构。get_walmart_offers 只返回购物车首选报价 —
Walmart 服务器只渲染该报价,因此即使
total_offer_count 较高,也只会返回一行。get_walmart_seller_products 的结果则限制在大约前 40 件商品,且没有分页或游标参数;请查看 total_count
以确认当前结果只是部分商品。两个卖家工具都需要从商品、搜索或报价结果中获取数字格式的
seller_catalog_id — 同一结果中的 GUID 格式
seller_id 会返回 404。
TikTok API
| 工具 | 描述 |
|---|---|
get_tiktok_profile | 获取用户资料(简介、粉丝数/关注数、获赞数) |
get_tiktok_user_posts | 列出用户的视频及其数据 |
get_tiktok_video | 获取单个视频的详细信息 |
get_tiktok_video_comments | 获取视频评论 |
get_tiktok_comment_replies | 获取特定评论的回复 |
search_tiktok_videos | 按关键词搜索视频 |
search_tiktok_users | 按关键词搜索用户 |
get_tiktok_hashtag | 获取话题标签详情及数据 |
get_tiktok_hashtag_videos | 列出某个话题标签下的视频 |
get_tiktok_user_followers | 获取用户的粉丝列表 |
get_tiktok_user_followings | 获取用户的关注列表 |
get_tiktok_trending_searches | 搜索当前热门词(约 90 个,不支持地区筛选) |
get_tiktok_trending_videos | 获取部分热门视频(每次调用约 6 个) |
get_tiktok_search_suggestions | 获取关键词的搜索自动补全建议 |
get_tiktok_music | 获取一段音频的信息:艺人、专辑、时长、使用该音频的视频、排行榜排名 |
get_tiktok_music_videos | 列出使用某段音频的视频(每页约 14 个) |
search_tiktok_music | 按关键词搜索音频 |
get_tiktok_music_chart | 全球 Top 50 或 Viral 50 音频榜单 |
get_tiktok_user_similar | 与某用户相似的创作者(每页约 30 个) |
get_tiktok_user_playlists | 列出用户的播放列表(系列) |
get_tiktok_playlist_videos | 列出播放列表中的视频 |
get_tiktok_user_live | 用户当前是否在直播:直播间状态、标题、观看人数 |
get_tiktok_user_region | 账号注册地区及 sec_user_id |
每个 TikTok 工具消耗 1 个点数。热门内容、音频、播放列表、相似创作者、直播和地区工具会返回 TikTok 自有的数据结构,并针对上下文进行精简:较大的数字 ID 作为 JSON 数字可能会丢失精度,因此请使用字符串形式(id_str、sec_uid、sec_user_id)。无论 count 的值是多少,get_tiktok_trending_videos 每次调用都会返回约 6 个视频;get_tiktok_music_videos 会忽略 count(每页约 14 个)。长尾关键词可能没有搜索建议,但仍会计费。未知用户名在 get_tiktok_user_live 中会返回计费的 404,而在 get_tiktok_user_region 中会返回不计费的 404。
Instagram API
| 工具 | 描述 |
|---|---|
get_instagram_profile | 获取用户个人资料(简介、粉丝数、关注数和帖子数) |
get_instagram_user_posts | 分页列出用户的帖子 |
get_instagram_user_reels | 分页列出用户的 Reels |
get_instagram_user_tagged | 列出用户被标记的帖子 |
get_instagram_user_stories | 获取用户当前有效的快拍 |
get_instagram_post | 根据 url、media_id 或 shortcode 获取单条帖子 |
get_instagram_post_comments | 获取帖子的评论 |
get_instagram_comment_replies | 获取对特定评论的回复 |
search_instagram_users | 按关键词搜索用户 |
search_instagram_hashtags | 按关键词搜索话题标签 |
get_instagram_user_followers | 获取用户的粉丝列表 |
get_instagram_user_followings | 获取用户的关注列表 |
get_instagram_user_highlights | 列出用户的快拍精选(id、标题、封面、内容数量) |
get_instagram_highlight_stories | 获取某条快拍精选中的所有快拍及其媒体 URL |
search_instagram_reels | 按关键词分页搜索 Reels |
search_instagram_music | 按歌曲或艺人搜索音轨 |
get_instagram_music_posts | 列出使用某音轨的 Reels,并提供 Reels 总数 |
search_instagram_locations | 按名称搜索地点(id、地址、坐标) |
get_instagram_user_similar | 获取与某位创作者相似的账号 |
get_instagram_post_likers | 获取为帖子点赞的账号,并提供点赞总数 |
Instagram 按端点计价:get_instagram_profile、get_instagram_user_reels、
get_instagram_user_tagged 和 get_instagram_music_posts 消耗 1 个积分(首次查询用户名时,Reels 和标记内容消耗
2 个积分),其他工具消耗 2 个积分。传入用于获取下一页的
cursor 时,search_instagram_users 和 search_instagram_hashtags 消耗 8 个积分。任何请求在需要额外处理时最多可能消耗 10 个积分;
响应中的 credits_used 始终显示确切的扣费数。
Reddit API
| 工具 | 描述 |
|---|---|
search_reddit | 按查询搜索 Reddit 帖子,结果按相关性排序,并支持游标分页 |
get_reddit_post | 根据 URL 或 id 获取单条帖子(不含评论;详见下文) |
get_reddit_search_suggestions | 获取搜索自动补全建议 |
get_reddit_post_comments | 分页获取帖子的顶级评论 |
get_reddit_comment_replies | 获取对特定评论的回复 |
get_reddit_subreddit | 获取 subreddit 元数据和订阅人数 |
get_reddit_subreddit_posts | 列出 subreddit 的帖子动态 |
get_reddit_user | 获取 Reddit 用户的个人资料 |
get_reddit_user_posts | 列出 Reddit 用户发布的帖子 |
get_reddit_user_comments | 列出 Reddit 用户的评论 |
get_reddit_popular | 获取全站热门动态 |
get_reddit_trending | 获取当前热门搜索查询 |
search_reddit_comments | 按关键词搜索评论,并显示评论所在的帖子和 subreddit |
search_reddit_subreddits | 按关键词查找 subreddit,并显示订阅人数 |
每个 Reddit 工具消耗 1 个积分。需要注意两点:search_reddit 仅接受查询和游标,不提供排序或帖子类型筛选,结果按相关性排序(search_reddit_comments 支持按相关性、热门、最佳或最新排序);get_reddit_post 返回不含评论的扁平帖子对象,如需获取评论,请使用帖子 id 调用 get_reddit_post_comments。Reddit 是这里响应最慢的平台,通常每次调用需要 5–15 秒。
X API
| 工具 | 描述 |
|---|---|
search_x | 按关键词搜索推文和用户 |
get_tweet | 获取单条推文的完整详情 |
get_tweet_comments | 获取推文的回复(按排名或时间顺序排列) |
get_tweet_retweeters | 列出转发过推文的用户 |
get_x_user | 根据用户名获取用户资料 |
get_x_user_tweets | 列出用户的推文 |
get_x_user_replies | 列出用户的推文和回复 |
get_x_user_media | 列出用户包含媒体的推文 |
get_x_user_followers | 列出用户的关注者 |
get_x_user_followings | 列出用户关注的账号 |
get_x_trending | 获取某个国家的热门话题 |
search_x_communities | 按关键词查找 X 社区,并显示成员数量 |
get_x_community | 获取社区的描述、成员数量、主题和规则 |
get_x_community_tweets | 按相关性或最新程度列出社区帖子 |
get_x_user_tweets、get_x_user_replies 和 get_x_user_media 会返回
next_cursor,但不会返回 has_more,因此请持续翻页,直到游标不存在或时间线
返回空结果。
LinkedIn API
| 工具 | 描述 |
|---|---|
get_linkedin_person | 获取成员的完整资料、工作经历和教育背景 |
get_linkedin_person_about | 获取成员的关于/概览部分 |
get_linkedin_person_posts | 列出成员近期的帖子(最多 50 条) |
get_linkedin_company | 获取公司的资料、所在地和关联公司 |
get_linkedin_company_posts | 列出公司近期的帖子(最多 50 条) |
search_linkedin_jobs | 按关键词和地点搜索职位 |
get_linkedin_job | 获取职位列表的完整详情 |
get_linkedin_post | 获取单条帖子的完整详情 |
get_linkedin_post_comments | 获取帖子的评论,每页 10 条 |
所有工具都接受自定义用户名、标识或 ID,也可以接受完整的 LinkedIn URL。积分消耗因工具而异:
get_linkedin_person、get_linkedin_person_about、get_linkedin_company 和
get_linkedin_post 消耗 1 积分;get_linkedin_person_posts、
get_linkedin_company_posts、search_linkedin_jobs 和
get_linkedin_post_comments 每页消耗 10 积分;get_linkedin_job 消耗 30 积分。
成员联系信息、公司员工目录、按公司筛选的职位列表、
人员搜索和帖子搜索已不再提供,因此移除了这五种工具。get_linkedin_company 仍会返回少量精选员工信息;使用公司名称调用 search_linkedin_jobs 可替代按公司筛选的职位列表。
TikTok Shop API
| 工具 | 描述 |
|---|---|
search_tiktok_shop | 按关键词搜索 TikTok Shop 商品(美国商品目录,价格准确) |
get_tiktok_shop_search_suggestions | 为部分查询词提供关键词自动补全,支持 8 个地区 |
get_tiktok_shop_product | 完整商品详情(不含价格;约 44% 的搜索 ID 可解析) |
get_tiktok_shop_product_reviews | 分页获取商品评论,每次最多 200 条 |
get_tiktok_shop_categories | 全球分类树(28 个顶级分类,240 个节点) |
get_tiktok_shop_category_products | 列出某个分类 ID 下的商品,价格准确 |
get_tiktok_shop_shop_products | 列出卖家的商品目录,每页 30 件,价格准确 |
resolve_tiktok_shop_url | 将 TikTok Shop URL 或分享链接解析为商品/店铺 ID |
需要了解两点:get_tiktok_shop_product 不会返回价格(TikTok 会在商品页面隐藏价格)——准确价格可通过 search_tiktok_shop、get_tiktok_shop_shop_products 和 get_tiktok_shop_category_products 获取。此外,搜索返回的商品 ID 中,只有约 44% 能通过 get_tiktok_shop_product 解析(测得的 25 个 ID 中有 11 个),因为 TikTok Shop 没有其余商品的详情数据。此类未命中会通过 HTTP 404 状态表示,而不是响应正文中的字段;这是正常结果,无需重试——该工具会将其作为普通结果返回,状态为 status: "no_detail_data",以便 Agent 跳过该商品,而不是陷入循环。对于无法解析的 ID,get_tiktok_shop_product_reviews 通常仍可用:在测得的 8 个详情查询失败的 ID 中,8 个均通过评论查询返回 HTTP 200,且 8 个中有 7 个至少返回一条评论。
Threads
| 工具 | 描述 |
|---|---|
get_threads_profile | 按 user_id 或 username 获取 Threads 用户的个人资料详情 |
get_threads_user_posts | 获取用户的 Threads 帖子,使用游标分页 |
get_threads_user_replies | 获取用户的回复,使用游标分页 |
get_threads_post | 按 ID 或 threads.net URL 获取单条帖子 |
get_threads_post_comments | 获取帖子的回复,使用游标分页 |
search_threads_users | 搜索匹配名称或账号名的个人资料——Threads 唯一提供的搜索功能 |
Threads 的计费取决于用于指定用户的方式,而非端点:传入 user_id 时为 2 个点数,传入 username 时为 4 个点数。只有 get_threads_profile、get_threads_user_posts 和 get_threads_user_replies 接受用户名;其他三个始终为 2 个点数。建议优先使用 user_id——使用账号名需要额外进行一次查询。
Kuaishou(中国)
| Tool | 描述 |
|---|---|
get_kuaishou_profile | Kuaishou 用户的个人资料详情(10 个点数) |
get_kuaishou_user_posts | 用户的热门帖子,使用游标分页 |
get_kuaishou_user_live | 用户当前的直播状态 |
resolve_kuaishou_user | 将 Kuaishou 分享链接转换为用户 ID |
get_kuaishou_video | 通过作品 ID 或 URL 获取单个视频(2 个点数) |
get_kuaishou_video_comments | 视频评论,使用游标分页 |
get_kuaishou_comment_replies | 根评论下的回复 |
get_kuaishou_videos_batch | 单次调用最多获取 20 个视频(40 个点数) |
search_kuaishou | 在 Kuaishou 上搜索混合结果(10 个点数) |
search_kuaishou_videos | 视频搜索结果(10 个点数) |
search_kuaishou_users | 用户搜索结果(10 个点数) |
search_kuaishou_live | 直播搜索结果(10 个点数) |
get_kuaishou_tag_feed | 话题标签下的帖子,使用游标分页 |
get_kuaishou_trending | 热门、直播、购物、品牌和音乐排行榜 |
Kuaishou 按端点计费,而非统一费率:get_kuaishou_profile 和全部 4 个搜索工具各需 10 个点数,get_kuaishou_video 需 2 个点数,get_kuaishou_videos_batch 需 40 个点数,其他工具均需 1 个点数。
eBay
| Tool | 描述 |
|---|---|
search_ebay | 搜索在售或已售商品:价格、状况、竞价、运费、卖家评价 |
get_ebay_product | 获取单个商品的完整信息:价格、状况、图片、商品规格、运费、退货、拍卖状态 |
get_ebay_seller | 卖家资料卡:店铺名称、评价分数、已售商品、关注者、所在地 |
每次调用需 1 个点数。get_ebay_seller 提供的是资料卡,无法枚举商品目录——若要列出卖家的库存,请设置 seller 并且不提供关键词来使用 search_ebay。sold: true 会搜索已结束且实际售出的商品;在此视图中,eBay 不提供醒目的结果总数,因此 total_results 为 null。per_page 仅接受 60、120 或 240。
Target
| Tool | 描述 |
|---|---|
search_target_products | 搜索 Target.com:价格、评分、徽章和促销 |
get_target_category | 获取某个类别中的商品,结构与搜索结果相同,并附带面包屑导航 |
get_target_product | 按 TCIN 获取商品详情:价格、图片、规格、变体、配送方式 |
get_target_reviews | 获取评论、评分分布、各属性平均分和访客照片 |
get_target_availability | 查询 ZIP 附近所有 Target 门店的库存:数量、店内、取货、路边取货和门店配送状态、距离、地址、营业时间 |
每次调用需 1 个点数。get_target_product、get_target_reviews 和 get_target_availability 均为单次请求;搜索和类别查询可通过 page + count 分页。搜索、类别、商品和评论接口中的 store_id 仅用于设置价格对应的门店;get_target_availability 才是查询门店库存的工具。
Home Depot
| Tool | 描述 |
|---|---|
search_home_depot | 搜索 Home Depot:价格、品牌和型号、评分、各门店取货/配送情况 |
get_home_depot_product | 商品完整详情:价格、媒体、规格表、尺寸、文档、退货政策 |
get_home_depot_reviews | 完整评论内容、评分分布、各属性评分、卖家回复 |
每次调用需 2 个点数。搜索每页大小固定为 12,无法更改。评论每页返回 30 条;total_pages 表示最后一页,超过该页请求会返回 404。
Costco
| 工具 | 描述 |
|---|---|
search_costco | 按关键词或商品编号搜索:线上价格和原价、评分、仅限会员和库存标记、促销、筛选项 |
get_costco_category | 按类别获取商品,筛选条件和结果结构与搜索相同 |
get_costco_categories | 部门列表,或某个部门下的完整子类别树 |
get_costco_product | 最多获取 20 件商品的完整详情:描述、特点、规格、款式、购买限制、配送费、促销日期 |
get_costco_prices | 最多 10 家仓库的线上与店内价格:折扣、最终价格、促销日期、会员购买限制、价格代码 |
get_costco_availability | 一件商品在最多 10 家仓库的店内库存状态,以及自提和当日配送信息 |
get_costco_reviews | 商品评价,含评分分布和推荐人数;支持排序、星级筛选,每页最多 100 条 |
get_costco_warehouses | 查询美国邮编或坐标附近的仓库:warehouse_id、地址、营业时间、部门、服务、汽油价格 |
get_costco_gas_prices | 查询某个地点附近或指定仓库中 Costco 加油站的普通汽油、高级汽油和柴油价格 |
get_costco_coupons | 当前会员优惠券册:商品编号、优惠金额、最终价格、适用范围、限制、有效日期 |
get_costco_deals | 促销商品列表:新品、售完为止、寻宝特惠、会员精选、仅限线上、促销商品 |
get_costco_clearance | 某家仓库的清仓商品和经理降价商品,根据货架价格尾数解读价格代码 |
除多仓库工具外,每次调用消耗 1 个额度:get_costco_prices 每两个地点查询一次(线上价格算作一个地点),get_costco_availability 每家仓库查询一次;每 5 次查询计费 1 个额度,因此查询 10 家仓库需 2 个额度。
get_costco_warehouses 和 get_costco_gas_prices 在 country: "ca" 时每次消耗 2 个额度;通过 warehouse_ids 查询汽油价格时,每 5 家仓库消耗 1 个额度(加拿大每家仓库消耗 2 个额度)。
search_costco、get_costco_category 和 get_costco_deals 接受 warehouse_id,可为每条结果添加该仓库的店内价格、库存和价格代码。可通过 get_costco_warehouses 获取 ID。除 get_costco_coupons(仅限美国)外,所有工具的 country 均为 us(默认值)或 ca;search_costco、get_costco_product 和 get_costco_warehouses 还接受 uk、au、mx、jp、kr 和 tw,但仅用于关键词、排序和分页。get_costco_clearance 中的价格代码采用会员社区的解读方式(.97 表示清仓,.00/.88 表示经理降价;.49/.79/.89 表示可按需购买的特惠商品),并非 Costco 官方公布的信息,且只涵盖 Costco 在线列出的商品。
get_costco_coupons 默认返回约 200 个优惠中的前 50 个;传入 limit 可查看更多。
HEB
| 工具 | 描述 |
|---|---|
search_heb | 搜索 HEB 食品杂货商品:价格(美分)、促销状态、单位价格、规格、UPC、库存、EBT/SNAP、货架位置 |
get_heb_product | 完整详情:营养成分、配料、图片、相似商品、优惠券、EBT/SNAP、面包屑导航 |
get_heb_stores | 按邮编或城市查找门店:地址、营业时间、药房、履约渠道、距离 |
每次调用消耗 2 个额度。HEB 是一家总部位于德克萨斯州的食品杂货连锁店。传入 product_url(来自 search_heb),或传入 slug 和 product_id,即可获取商品详情。
Kroger
| 工具 | 描述 |
|---|---|
search_kroger | 搜索 Kroger 食品杂货商品:价格(美分)、促销/多件优惠、单位价格、UPC、库存、SNAP、饮食信息、评分 |
get_kroger_product | 完整详情:含过敏原和配料的营养信息、评分分布、门店货架位置、饮食标记、SNAP、尺寸 |
每次调用消耗 2 个额度。Kroger 旗下有 Kroger、Ralphs、Fred Meyer、Harris Teeter、King Soopers、Fry's 等品牌。传入 product_url(来自 search_kroger)或 upc。
Mercado Libre
墨西哥、巴西、阿根廷和哥伦比亚的 Mercado Libre(巴西称 Mercado Livre)商品数据:商品列表、价格、卖家、评价、买家提问和类别畅销商品,无需注册 OAuth 应用。
| 工具 | 说明 |
|---|---|
search_mercadolibre | 按关键词或卖家搜索 mx、br、ar 或 co 的商品列表:价格、标价、折扣、分期付款、页面显示的卖家、评分、已售数量、免费配送和 Full 标记、赞助标记;可按商品状况、价格范围、最低折扣、免费配送、Full、官方商店和免息分期筛选;按相关性或价格排序;每页约 48 条 |
get_mercadolibre_product | 按 URL、product_id 或 item_id 查询单个商品或商品列表:价格、促销、带信誉信息的购买框卖家、库存、配送、星级分布、变体、规格、描述、图片、类别 |
get_mercadolibre_reviews | 每页 15 条评价,包含评分、文本、翻译时的原文、日期、点赞数、评价者所在国家和照片;可按星级筛选 |
get_mercadolibre_questions | 商品列表上的买家提问及卖家的回答和回答日期;使用 next_offset 翻页 |
get_mercadolibre_best_sellers | 类别排名前 20 的商品(mx、ar、co;不含巴西) |
每次调用需 2 个积分;get_mercadolibre_reviews 需 1 个积分。每次搜索最多返回 42 页(约 2,000 条结果),因此可按价格范围、商品状况或卖家筛选以查看更多结果;仅支持按相关性或价格排序。已售数量是下限(“至少 500”),并非精确数量。只有 Mercado Libre 显示卖家名称时,搜索结果行才会显示该名称;get_mercadolibre_product 会返回购买框卖家,但无法获取商品的全部卖家列表。Mercado Libre 可能会自行缩小查询范围(巴西和阿根廷可能会应用“全新”筛选);auto_applied_filters 会列出已应用的筛选条件。商品、评价和提问查询不接受 country:国家由 ID 前缀(MLM、MLB、MLA、MCO)或 URL 确定。不支持智利。搜索结果为零时,会返回一个空白且计费的页面;查询未知商品、商品条目或卖家昵称,或查询没有提问的商品列表时,会返回说明原因的 404 错误并计费。
Booking.com
| 工具 | 说明 |
|---|---|
search_booking | 搜索指定目的地和住宿日期的房源:实时每晚价格、评价分数、房型 |
get_booking_hotel | 获取单个房源的完整信息:房间和价格方案、设施、住宿规则、政策、图片 |
get_booking_reviews | 房客评价,包含按类别划分的评分明细以及 Booking 自带的摘要 |
每次调用需 1 个积分。搜索每页返回 25 个房源;get_booking_hotel 和 get_booking_reviews 均为单次查询。
Airbnb
| 工具 | 说明 |
|---|---|
search_airbnb | 搜索住宿,包含住宿总价和每晚价格、完整折扣明细、评分、坐标 |
get_airbnb_listing | 获取单个房源的完整信息:描述、接待人数、按组归类的便利设施、房东、住宿规则、评分明细 |
get_airbnb_reviews | 评价正文,包含每条评价的评分、日期和评价者资料 |
每次调用需 1 个积分。search_airbnb 的 page 和 cursor 二选一;同时发送两者会被拒绝,且 cursor 优先。每页 18 个房源。get_airbnb_reviews 使用 limit 和 offset 翻页。
Tripadvisor
| 工具 | 描述 |
|---|---|
resolve_tripadvisor_location | 从这里开始——将地点或商家名称解析为 geo_id / location_id 组合 |
search_tripadvisor | 在某个地理区域中搜索餐厅、酒店或景点,按 TripAdvisor 排名排序 |
get_tripadvisor_location | 获取单个地点的完整信息:评分分布图、子评分、城市排名、设施以及第一页评论 |
get_tripadvisor_reviews | 获取一页评论:评分、出行日期和类型、评论者资料、管理方回复 |
每次调用消耗 2 点数。先使用 resolve_tripadvisor_location 获取其他工具所需的 geo_id / location_id 组合。搜索每页返回 30 条,超出最后一页时会返回 404,而不是空结果。餐厅评论每页返回 15 条,酒店和景点每页返回 10 条,因此翻看后续页面时,category 必须与地点自身的类型一致。
Yelp
| 工具 | 描述 |
|---|---|
search_yelp | 按 Yelp 排名顺序搜索商家:评分、评论数、价格区间、类别、营业时间 |
get_yelp_business | 获取单个商家的完整信息:各星级评分分布图、联系方式、营业时间、设施、卫生检查、问答 |
get_yelp_reviews | 获取一页评论:评分、全文、作者资料、照片、店主回复 |
每次调用消耗 2 点数。Yelp 将每页大小固定为 10。get_yelp_business 已免费包含第一页评论。超出最后一页的评论页会返回 404,而不是空结果。
Zillow
| 工具 | 描述 |
|---|---|
search_zillow | 搜索某个地区的房源:价格、卧室数、浴室数、居住面积、Zestimate、坐标、上市天数 |
get_zillow_property | 获取房源完整信息:价格和价格历史、Zestimate、税务历史、RESO 事实、学校、照片 |
get_zillow_agent_reviews | 获取 Zillow AGENT 的资料和评论、专长、执照、服务区域、销售数量 |
每次调用消耗 1 点数。只有 search_zillow 支持分页。get_zillow_agent_reviews 获取的是 AGENT 资料,而不是房产信息。
Redfin
| 工具 | 描述 |
|---|---|
search_redfin | 房源:价格、每平方英尺价格、卧室数、浴室数、居住面积、地块面积、建造年份、照片 |
get_redfin_property | 获取房源完整信息:Redfin Estimate、MLS 信息表、价格和税务历史、学校、气候风险、可比房源 |
get_redfin_market | 获取某个地区的市场统计数据:挂牌价和成交价中位数、售挂比、上市天数、竞争力评分 |
每次调用消耗 1 点数。search_redfin 使用 page + limit 分页,每页最多 350 条房源;另外两个工具均为单次调用。
Realtor.com
| 工具 | 描述 |
|---|---|
search_realtor | 按地点、半径或 Agent 搜索美国待售、待成交、出租或已售房源:价格、卧室数、浴室数、平方英尺、地块、建成年份、车库、HOA、类型、N 天内挂牌/售出/降价、房源文本中的关键词(必须全部匹配)、新建房屋、止赎房产、开放看房;每次调用最多 200 条 |
get_realtor_property | 按 ID 或 URL 查询单处房产:价格和税费历史、三种价值估算及其历史和预测、学校、洪水/野火/噪音风险、挂牌 Agent 和经纪公司 |
get_realtor_locations | 自动补全城市、县、ZIP 邮编、社区、学校和地址,并提供市场的 slug_id 和地址的 property_id |
get_realtor_market | 查询城市、县或 ZIP 邮编的市场统计数据:挂牌价、成交价和租金中位数、每平方英尺价格、在市天数、同比和环比变化,按房产类型细分 |
search_realtor_agents | 按城市、ZIP 邮编或姓名搜索 Agent:评分、评价、在售房源和价格范围、去年售出的房屋、经纪公司和办公室 |
get_realtor_agent | 查询一位 Agent 的完整档案,包含所有评价和四项子评分 |
每次调用消耗 1 个额度。search_realtor 每页最多返回 200 条房源(默认 50 条),并提供搜索结果中的前 10,000 条(page x page_size <= 10,000);若要查看更多结果,请按价格区间、房产类型或半径细分较大的区域。在美国不披露成交价的州(德克萨斯州、犹他州、怀俄明州及其他约九个州),已售房产的价格为 null,但仍会返回成交日期。查询未知的房产或 Agent ID 也会计费,并返回 404。
Rightmove
| 工具 | 描述 |
|---|---|
get_rightmove_locations | 将英国地点、邮区、邮编或车站转换为搜索和 Agent 查询所需的 location_id |
search_rightmove | 搜索英国待售或出租房产:价格(英镑)、卧室数、浴室数、类型、必备条件、排除条件、产权类型、近几天内新增、待成交、半径、家具配置、出租类型;每页 24–25 条 |
get_rightmove_property | 查看单条房源的完整信息:产权类型和剩余租期、市政税等级、物业服务费、地租、EPC、房间、楼层平面图、洪水风险、宽带、车站、Agent |
get_rightmove_sold | 查询某个城镇、邮区或邮编的成交价:每页 25 个地址,每个地址包含自 1995 年以来的成交记录,以及该地区过去一年的平均价格 |
get_rightmove_sold_property | 查询一个已售地址:每笔成交的价格、日期、产权类型、新建房屋标记和涨跌幅百分比,以及最近一条已归档房源 |
search_rightmove_agents | 查询某个地点的房地产和出租经纪分支机构:电话、地址、品牌和公司 ID、档案 URL |
get_rightmove_agent | 按 ID 或 URL 查询一家分支机构:地址、电话、从属关系、房源数量和简介 |
每次调用消耗 1 个额度。Rightmove 搜索不支持关键词筛选;请根据返回的 summary 和 key_features 进行匹配。每次搜索的分页上限:search_rightmove 为 42 页(约 1,000 条房源),get_rightmove_sold 为 40 页,search_rightmove_agents 为 50 页;若要查看更多结果,请按价格区间、类型或更小的区域细分。成交价仅涵盖英格兰和威尔士(不包括苏格兰和北爱尔兰)。在售房源不提供价格历史记录,因此查询某个地址过去的成交记录时,请使用 get_rightmove_sold_property。已下架的房源或未知 ID 会计费,并返回 404。
Indeed
| 工具 | 描述 |
|---|---|
search_indeed_jobs | 招聘信息:职位名称、雇主、评分、地点、薪资范围、职位类型、申请途径 |
get_indeed_job | 单条招聘信息的完整内容:描述文本和 HTML、结构化薪资、福利、原始 ATS 链接 |
get_indeed_company | 雇主资料:行业、总部、规模、营收、CEO 认可度、各类别评分、开放职位 |
get_indeed_company_reviews | 员工评价,包含各类别评分、优缺点、评价者的职位名称和地点 |
每次调用消耗 2 个积分。职位搜索每页返回 10 条招聘信息,公司评价每页返回 20 条。get_indeed_job 和 get_indeed_company 均为单次调用。
Glassdoor
| 工具 | 描述 |
|---|---|
resolve_glassdoor_company | 从这里开始——将公司名称解析为其他工具所需的 employer_id |
get_glassdoor_company | 雇主资料:评分、星级分布、CEO 认可度、规模和营收范围、奖项 |
get_glassdoor_reviews | 最多三条完整评价,包含各维度评分和雇主回复,以及完整评分统计 |
get_glassdoor_salaries | 按职位名称列出的薪资:基本工资和总薪资的 P10-P90 百分位数、样本数量、薪资周期 |
每次调用消耗 1 个积分。请先使用 resolve_glassdoor_company 获取 employer_id。只有 get_glassdoor_salaries 支持分页(每页 10 个职位名称;page_count 表示总页数)。get_glassdoor_reviews 返回最多三条完整评价及完整评分统计,而不是分页的评价列表。
Apple App Store
| 工具 | 描述 |
|---|---|
search_app_store | 最多返回 200 个完整结构化的 App,也可用于批量获取元数据和查找发布者 |
get_app_store_app | 完整应用详情:开发者身份、价格、历史和当前版本评分、版本说明、屏幕截图 |
get_app_store_reviews | 一页评价:星级评分、标题、完整文本、作者,以及评价所针对的应用版本 |
每次调用消耗 1 个积分。评价按每页 50 条分页,可查看第 1 至 10 页,并在第 10 页处严格停止:每个店面最多可匿名获取 500 条评价,这是 Apple 的限制;如需查看更多,可指定其他 country。搜索和应用详情不支持分页。
Google Play
| 工具 | 描述 |
|---|---|
search_google_play | 排名靠前的应用:包名称、开发者、评分、安装量、价格和应用内购买价格范围、屏幕截图 |
get_google_play_app | 完整商店详情:实际安装量、星级分布图、应用内购买、权限、Data safety 表格 |
get_google_play_reviews | 一页评价:星级评分、完整文本、点赞数、开发者回复、应用版本 |
每次调用消耗 2 个积分——使用独立于 google 的命名空间,不适用 Google 豁免价格。评价采用游标分页,游标是不透明的、只能使用一次,并且会同时编码排序方式和位置,因此必须将游标与生成它时使用的 sort 一并传回。指向最后一条评价之后位置的游标会返回 404。搜索和应用详情不支持分页。
G2 软件评价
| 工具 | 说明 |
|---|---|
search_g2_software | 搜索 B2B 软件:星级评分、评价数量、供应商、类别;每行都包含 product_id |
get_g2_product | 完整档案:各星级分布、定价版本、功能组、集成、替代产品、AI 优缺点 |
get_g2_reviews | 一页评价:评分、点赞/点踩、解决的问题、评价者公司信息、已验证标记 |
每次调用 5 个积分,是 Scavio 上费用最高的平台。search_g2_software 使用 page + limit 分页(我们这边上限为 100);get_g2_reviews 每页固定为 10 条,可翻页到远超 G2 自带组件链接所指向的 10 页。get_g2_product 一次调用即可获取完整结果。
Capterra 软件评价
| 工具 | 说明 |
|---|---|
search_capterra_software | 搜索 B2B 软件:20 个排名靠前的产品,包含评分、评价数量和付费推广标记 |
get_capterra_product | 完整档案:各星级分布、四项评分标准、定价表、功能,以及 25 条近期评价 |
get_capterra_reviews | 一页评价:总体评分及五项标准的评分、优点、缺点、考虑过的替代产品 |
每次调用 2 个积分。只有 get_capterra_reviews 支持分页:每页 25 条,上限为第 100 页——超过后,Capterra 会返回状态码 200 和第一页结果,因此请检查实际返回的内容。get_capterra_product 已包含最近的 25 条评价。
Trustpilot
| 工具 | 说明 |
|---|---|
search_trustpilot | 按关键词在一个国家/地区搜索商家:域名、TrustScore、星级、评价数量、类别、网站、已发布的电子邮件/电话/地址;每页最多 100 条 |
get_trustpilot_business | 按域名或 URL 获取完整档案:评分分布、各语言的评价数量、认领和验证状态、回复率及回复天数、消费者提醒、AI 摘要和主题、相似商家、最新的 20 条评价 |
get_trustpilot_reviews | 获取一页 20 条评价,可按星级、语言、日期范围、主题、文本、仅已验证和有回复筛选;按时间由新到旧或相关性排序 |
get_trustpilot_categories | 类别树(22 个顶级类别、189 个子类别),或匹配名称的类别 |
get_trustpilot_category | 按国家/地区获取类别中的排名商家:排序方式、最低星级(TrustScore 四舍五入为星级,因此 4 包含 3.8+)、仅已认领档案;每页 20 条 |
get_trustpilot_review | 按 24 个字符的 ID 获取单条评价及其对应的商家 |
每次调用 2 个积分。get_trustpilot_reviews 每个筛选组合提供 10 页、每页 20 条,即 200 条评价;要读取更多内容,请拆分为不同集合(每个 stars 值、每种 language、每个 date_range),而不是继续翻页。使用 date_range 时,total_filtered 也可用于估算评价发布速度。只有商家已发布电子邮件和电话时,才会显示这些信息;只有当 Trustpilot 为所选 language 提供 AI 摘要和主题时才会显示(默认值为 en)。不提供 TrustScore 历史记录。未知域名、类别或评价 ID 会产生计费的 404 错误,并指出未找到的内容。
Google Ads Transparency
| 工具 | 描述 |
|---|---|
resolve_google_ads_advertiser | 从这里开始——将品牌名称或域名解析为 advertiser_id |
search_google_ads | 某个广告主投放的所有 Google 广告,包含首次/最后出现日期以及实际投放天数 |
get_google_ads_creative | 单个创意的完整信息——唯一包含尺寸变体、展示量区间和地区细分的工具 |
每次调用消耗 1 个 credit。先使用 resolve_google_ads_advertiser,将品牌名称或域名转换为 advertiser_id。search_google_ads 使用游标分页,每页 100 条广告——重新发送同一组筛选条件,并附上游标。get_google_ads_creative 是唯一包含创意历史记录、地区细分和展示量区间的工具。
Meta Ad Library
| 工具 | 描述 |
|---|---|
search_meta_ads | 搜索 Meta Ad Library,获取完整创意信息:广告文案、标题、CTA、媒体、平台和投放日期 |
get_meta_ads_advertiser | 按数字页面 ID 获取 Facebook 公共主页投放的所有广告,并提供相同的创意详情 |
get_meta_ad | 按存档 ID 获取单条广告的完整信息:创意、广告主、投放日期、平台和政治广告披露信息 |
每次调用消耗 1 个 credit,每个游标分页也消耗 1 个 credit:第 1 页返回 30 条广告,之后每页返回 10 条,因此遍历完整查询的成本会随深度增加。search_meta_ads 和 get_meta_ads_advertiser 都使用游标分页——遍历 has_next_page。get_meta_ad 一次调用即可返回结果。
SEC EDGAR
| 工具 | 描述 |
|---|---|
resolve_sec_company | 从这里开始——将公司名称或股票代码解析为其他所有信息所使用的 CIK |
get_sec_company | 申报者资料:法定名称和曾用名、SIC 行业、EIN、LEI、财年结束日期、股票代码 |
get_sec_filings | 某个申报者的一页申报文件:受理编号、表格、日期、8-K 项目代码、文档链接 |
get_sec_concept | 某个申报者针对一个 XBRL 概念报告的所有数值,按时间从新到旧排列,并附来源申报文件 |
get_sec_facts | 某个申报者报告的所有 XBRL 概念索引——用它来查找要向 get_sec_concept 查询的内容 |
search_sec_filings | EDGAR 全文搜索,范围为 2001 年至今,可按公司、表格、行业和州筛选 |
使用官方免费的 EDGAR JSON API,每次调用消耗 1 个 credit。先使用 resolve_sec_company,将名称或股票代码转换为 CIK。get_sec_filings 使用 page + limit 分页;search_sec_filings 最多可翻到第 100 页,因为索引不允许结果窗口超过 10,000 条。
Companies House
| 工具 | 描述 |
|---|---|
search_companies_house | 从这里开始——按名称搜索英国公司注册簿,获取 company_number |
get_companies_house_company | 完整注册条目:状态、类型、日期、注册办公地址、SIC 代码、账目到期日 |
get_companies_house_officers | 现任和已离任高管:职务、任命和离任日期、国籍、出生日期 |
get_companies_house_filing_history | 按时间从新到旧排列的申报记录:日期、类型代码、描述、已申报 PDF 的链接 |
使用官方英国公司注册簿,每次调用消耗 1 个 credit。先使用 search_companies_house 获取 company_number。搜索每页返回 20 条,最多可翻到第 50 页——注册簿对每个查询词最多提供 1,000 条结果,无论打印的命中数是多少;之后请求第 51 页会返回 416。高管记录(每页 35 条)和申报历史没有页数上限;超过末页后,它们会返回普通的 200 响应和空列表,看起来与没有任何记录完全相同。
账户
| 工具 | 描述 |
|---|---|
get_usage | 查看额度余额、套餐和使用统计 |
关于 Scavio
Scavio 是一个统一的面向 AI Agent 的搜索 API,也是面向开发者的数据 API。一个密钥,结构化 JSON:
- Google Search API — SERP 结果、新闻、图片、地图和知识图谱
- Extract — 将任意 URL 读取为 Markdown、纯文本或原始 HTML
- Amazon Product API 和 Walmart Product API — 商品搜索和详情;此外还包括 eBay、Target、Home Depot 和 Costco(各仓库价格、库存、油价、优惠券册),以及 Mercado Libre(墨西哥、巴西、阿根廷和哥伦比亚的商品列表、卖家、评论、问题和畅销商品)
- TikTok API、Instagram API、Reddit API、X API、LinkedIn API 和 YouTube API — 社交媒体和视频数据
- 旅行和本地服务 — Booking.com、Airbnb、Tripadvisor、Yelp
- 房地产 — Zillow、Redfin、Realtor.com(房源、已售可比房源、市场统计、经纪人)、Rightmove(英国房源、英格兰和威尔士自 1995 年以来的成交价、经纪人)
- 职位和雇主数据 — Indeed、Glassdoor
- 应用、软件评论和广告资料库 — App Store、Google Play、G2、Capterra、Trustpilot(企业资料、筛选后的评论、类别排名)、Google Ads Transparency、Meta Ad Library
- 公司申报文件 — SEC EDGAR、Companies House 团队将其用作 SerpAPI 替代方案,获取结构化的多平台数据——请参阅 Tavily 与 Scavio 对比,了解两者的正面对比。
前往 scavio.dev 免费获取 Search API 密钥。
许可证
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。