Autom

Autom MCP 服务

适用于 Autom SERP API 的官方 Model Context Protocol 服务。

以结构化 JSON 返回 Google、Bing 和 Brave 搜索结果，涵盖网页、地图、新闻、购物、图片、职位和 AI Mode。

Claude、Cursor、VS Code、Windsurf 以及任何 MCP 客户端都可以通过它调用 API 工具。支持通过 stdio（本地）或 Streamable HTTP（自托管）运行。

要求

• Node.js 20 或更高版本
• Autom API 密钥 — 注册，然后从控制面板复制密钥

托管服务（推荐）

Autom 会为你运行此服务，地址为 https://mcp.autom.dev/（Streamable HTTP）。在 x-api-key 请求头中提供 API 密钥；无需安装。

claude mcp add --transport http autom https://mcp.autom.dev/ --header "x-api-key: YOUR_API_KEY"

{
  "mcpServers": {
    "autom": {
      "url": "https://mcp.autom.dev/",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

托管服务和此软件包提供相同的 API；如果你需要使用 stdio、自定义网络出口或自托管，请在本地运行此软件包。

本地运行

Claude Code

claude mcp add autom --env AUTOM_API_KEY=YOUR_API_KEY -- npx -y @automdev/mcp

Claude Desktop、Cursor、Windsurf 和其他客户端

将服务添加到客户端的 MCP 配置中（claude_desktop_config.json、.cursor/mcp.json……）：

{
  "mcpServers": {
    "autom": {
      "command": "npx",
      "args": ["-y", "@automdev/mcp"],
      "env": {
        "AUTOM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "autom": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@automdev/mcp"],
      "env": {
        "AUTOM_API_KEY": "${input:autom-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "autom-api-key",
      "description": "Autom API key",
      "password": true
    }
  ]
}

Claude Desktop 扩展

从发布页面下载 .mcpb 压缩包并打开；Claude Desktop 会提示你输入 API 密钥。

Docker

docker build -t autom-mcp .
docker run -i --rm -e AUTOM_API_KEY=YOUR_API_KEY autom-mcp

工具

工具	描述
bing_search	通过 API 查询 Bing Search，并检索结构化的自然搜索结果（标题、链接、摘要、排名）。
brave_images	通过 API 搜索 Brave Images，并检索支持分页和 SafeSearch 的结构化图片结果。
brave_search	通过 API 搜索 Brave Search，并检索支持分页的结构化自然搜索结果。
brave_videos	通过 API 搜索 Brave Videos，并检索支持分页和 SafeSearch 的结构化视频结果。
duckduckgo_search	通过 API 查询 DuckDuckGo，并检索包含地区和语言信息的结构化自然搜索结果。
finder_google_countries	搜索 Google 国家/地区，并检索国家/地区代码（免费 Finder 端点）。
finder_google_languages	搜索 Google 语言，并检索语言代码（免费 Finder 端点）。
finder_google_locations	查找 Google 支持的地点，并检索地点 ID 和国家/地区代码（免费端点）。
google_images	通过 API 搜索 Google Images，并检索图片结果（URL、标题、来源、尺寸）。
google_jobs	通过 API 抓取 Google Jobs 结果，并检索包含职位名称、公司、地点和分页信息的结构化职位列表。
google_maps	通过 API 搜索 Google Maps，并检索结构化地点结果（地址、网站、电话）。
google_news	通过 API 搜索 Google News，并检索支持分页的结构化新闻结果。
google_search	通过 API 抓取 Google Search 结果，并检索支持分页的结构化 SERP 数据。
google_search_ai	通过 API 查询 Google AI Mode。返回包含 text_blocks、references 和 shopping_results 的 JSON。
google_search_autocomplete	通过 API 获取给定查询的 Google Search 自动补全建议。
google_search_light	通过 API 抓取轻量版 Google Search 结果：速度快、成本效益高，且仅包含自然搜索结果。
google_shopping	通过 API 抓取 Google Shopping 结果，并检索包含价格、评分和商家数据的结构化商品列表。
google_videos	通过 API 搜索 Google Videos，并检索包含元数据的结构化视频结果。
search	一次调用按顺序遍历搜索引擎，并返回首批自然搜索结果。engines=auto 会依次尝试 Google、Brave、Bing、DuckDuckGo、Yahoo 和 Baidu。省略 gl 时默认为 us，省略 hl 时默认为 en。没有 pa…
stats	查看过去一小时内某个引擎或端点的基础设施运行状况。数据不限定于你的账户或租户。按账户启用：HTTP 403 表示请联系支持团队启用。
usage	获取 Autom 账户的实时用量统计和额度余额。
yahoo_search	通过 API 查询 Yahoo，并检索包含国家/地区和语言信息的结构化自然搜索结果。
每个调用 API 的工具都会消耗额度。JSON 结果以文本形式返回；图片以内联形式返回，其他文件（PDF……）则作为嵌入资源返回，最大为 4 MB。

Streamable HTTP

npx @automdev/mcp --http --port 3000

端点为 POST /mcp（无状态，返回 JSON）。每个客户端都在 x-api-key 标头（或 Authorization: Bearer <key>）中发送自己的密钥；服务端不会使用自己的密钥。默认绑定到 127.0.0.1，并会拒绝浏览器来源，除非你将其加入允许列表——对外开放前，请将其置于 TLS 后面。

createHttpHandler() 已导出，可用于兼容 Fetch 的运行时（Cloudflare Workers、Deno、Bun）：

import { createHttpHandler } from "@automdev/mcp";

export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

安全

• API 密钥从 AUTOM_API_KEY（stdio）或请求标头（HTTP）读取，并会从错误消息中移除。
• 从网站获取的内容不可信：服务端指令会告诉模型将其视为数据，而非指令。
• 请参阅 SECURITY.md 报告漏洞。

开发

npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js

基于 SDK 构建

该服务使用官方 Node.js SDK（@automdev/sdk）。

所有 Autom SDK

SDK	Package	Install
Node.js	@automdev/sdk	npm install @automdev/sdk
Python	automdev	pip install automdev
Go	autom-go	go get github.com/automdev/autom-go
.NET	Autom	dotnet add package Autom
Ruby	autom	gem install autom
PHP	autom/sdk	composer require autom/sdk
Java	autom-java	从源代码构建，请参阅其 README
CLI	@automdev/cli	npm install -g @automdev/cli
MCP 服务	@automdev/mcp	npx -y @automdev/mcp

许可证

MIT — 详见 LICENSE。