# Antigravity

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

Canonical URL: https://s1.dev/zh/docs/integrations/antigravity

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

## Agent 可用的工具

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

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

## 安装

### 作为插件安装

从 GitHub 仓库安装插件：

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

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

### 在 `mcp_config.json` 中手动配置

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

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

<Tabs items={['OAuth', 'API key']}>

<Tab value="OAuth">

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

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

</Tab>

<Tab value="API key">

在 [app.s1.dev](https://app.s1.dev) 创建 Key，并作为 Bearer token 发送：

```json
{
  "mcpServers": {
    "search1api": {
      "serverUrl": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}
```

不要把 Key 写进会提交到版本库的工作区 `.agents/mcp_config.json`。

</Tab>

</Tabs>

## 验证

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 无效或已被撤销。参见[认证](https://s1.dev/zh/docs/essentials/authentication)。

### `402 Payment Required`

账户积分已用完。参见[积分与限制](https://s1.dev/zh/docs/essentials/credits-and-limits)。

## 计费

Antigravity 发起的工具调用就是普通的 API 调用，与直接调用接口的积分消耗和费率相同。一次搜索或新闻请求消耗 1 积分；读取页面每页 1 积分；`ask` 每次 5 积分。参见[积分与限制](https://s1.dev/zh/docs/essentials/credits-and-limits)。

## 相关文档

- [MCP 服务器](https://s1.dev/zh/docs/integrations/mcp)：完整的端点参考、OAuth 细节和其他客户端
- [Agent skill](https://s1.dev/zh/docs/integrations/skills)：教会 Agent *何时*搜索，而不只是如何搜索
- [Antigravity 插件文档](https://antigravity.google/docs/plugins) · [Antigravity MCP 文档](https://antigravity.google/docs/mcp)

来源：[github.com/superagents-lab/search1api-mcp](https://github.com/superagents-lab/search1api-mcp)