Search1API文档

Antigravity

让 Antigravity 的 Agent 实时访问网络:安装 Search1API 插件,或在 mcp_config.json 中配置托管的 MCP 服务器。

Search1API 以 Antigravity 插件的形式发布。插件会把 Antigravity 连接到托管的 Search1API MCP 服务器,并附带 Search1API skill,Agent 可以跨引擎搜索、阅读页面、查找新闻、查看热门内容,并在回答中引用来源。Antigravity App、CLI 和 IDE 都可以使用。

Agent 可用的工具

工具作用必填参数
search网页搜索query
news新闻搜索query
ask描述你的需求,由 Search1API 选择引擎和时间范围query
crawl读取 URLurl
sitemap列出站点的链接url
trendingGitHub / Hacker News 热门search_service
render_results将已选定的现有来源以卡片或易读列表的形式展示;不消耗搜索积分results
send_feedback向 Search1API 团队报告错误结果、无法解决的报错或缺失的能力;不消耗积分message

插件还会添加 search1api skill,告诉 Agent 什么时候直接读取链接、什么时候搜索,如何选择引擎、对比来源,以及如何引用结果。也可以用 /search1api 直接调用。

安装

作为插件安装

从 GitHub 仓库安装插件:

agy plugin install https://github.com/superagents-lab/search1api-mcp/tree/main/antigravity-plugin

插件里只有服务器地址。Search1API 服务器首次连接时,Antigravity 会打开浏览器,用你的 Search1API 账号登录即可,没有账号可以在 s1.dev 注册。整个过程不需要 API Key。

在 mcp_config.json 中手动配置

Antigravity 从两个文件读取 MCP 服务器:

文件作用范围
~/.gemini/config/mcp_config.json所有项目
.agents/mcp_config.json单个工作区

只配置端点即可。Antigravity 会向 Search1API 的授权服务器注册自己,并提示你登录:

{
  "mcpServers": {
    "search1api": {
      "serverUrl": "https://mcp.search1api.com/mcp"
    }
  }
}

验证

  1. 运行 agy plugin list,或在 App 中打开 Customizations > Installed,确认 Search1API 已安装并启用。
  2. 在对话中输入:Find this week's top news on AI coding agents and cite each source.
  3. 如果 Antigravity 请求确认,批准这次工具调用。

故障排查

插件已安装但没有工具

登录还没完成。在 Customizations > Installed(CLI 中用 /plugin)重新启用插件,并在浏览器中完成登录。

401 Unauthorized

使用 OAuth 时,会话已过期或被撤销,在插件的 MCP 标签页重新登录即可。使用 API Key 时,Key 无效或已被撤销。参见认证。

402 Payment Required

账户积分已用完。参见积分与限制。

计费

Antigravity 发起的工具调用就是普通的 API 调用,与直接调用接口的积分消耗和费率相同。一次搜索或新闻请求消耗 1 积分;读取页面每页 1 积分;ask 每次 5 积分。参见积分与限制。

来源:github.com/superagents-lab/search1api-mcp

本页内容