Autom

dev.autom由 autom.dev 发布官方发布者v0.1.0更新于 Nov 7, 2026

Google, Bing and Brave search results as structured JSON — web, maps, news, shopping, images, jobs…

已验证Streamable HTTP可网页运行网页搜索与抓取数据与分析

概览

AI 生成的概览

封装 Autom SERP API，让助手执行 Google、Bing、Brave、DuckDuckGo 和 Yahoo 搜索并获取结构化 JSON 结果。

可以做什么
  • 跨 Google、Bing、Brave、DuckDuckGo 和 Yahoo 搜索网页，或一次调用按顺序轮询多个引擎
  • 搜索垂直频道：Google 地图地点、Google 新闻、Google 购物商品、Google 招聘职位、图片和视频
  • 查询 Google AI Mode，获取文本块、引用和购物结果
  • 获取 Google 搜索自动补全建议，并查询支持的国家、语言和地区代码
  • 查看账户积分余额与用量，以及各引擎的基础设施健康状况
适用场景
适合需要以结构化数据而非网页文本获取实时网页、新闻、购物、招聘或本地地点结果的场景，也适合希望用一个密钥覆盖多个搜索引擎的用户。
运行要求
需要 Autom API 密钥：托管端点通过 x-api-key 请求头发送，本地包通过 AUTOM_API_KEY 环境变量提供。本地包需要 Node.js 20 或更高版本；mcp.autom.dev 上的托管服务无需安装任何东西。认证方式还声明了 OAuth。
安装前请注意
每个调用 API 的工具都会消耗积分，费用与你的 Autom 账户挂钩。API 密钥属于机密，应避免写入共享配置。抓取的网页内容不可信，可能包含注入指令。stats 工具不按账户隔离，可能需要联系支持开通。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Autom，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/dev.autom%2Fmcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "autom": {
      "type": "http",
      "url": "https://mcp.autom.dev/"
    }
  }
}

README

Autom MCP Server

Official Model Context Protocol server for the Autom SERP API.

Google, Bing and Brave search results as structured JSON — web, maps, news, shopping, images, jobs and AI Mode.

It lets Claude, Cursor, VS Code, Windsurf and any MCP client call the API as tools. Runs over stdio (local) or Streamable HTTP (self-hosted).

Requirements

  • Node.js 20 or newer
  • a Autom API key — sign up, then copy it from the dashboard

Hosted server (recommended)

Autom runs this server for you at https://mcp.autom.dev/ (Streamable HTTP). Send your API key in the x-api-key header; nothing to install.

sh
claude mcp add --transport http autom https://mcp.autom.dev/ --header "x-api-key: YOUR_API_KEY"
json
{  "mcpServers": {    "autom": {      "url": "https://mcp.autom.dev/",      "headers": {        "x-api-key": "YOUR_API_KEY"      }    }  }}

The hosted server and this package expose the same API; run the package locally when you want stdio, your own network egress, or to self-host it.

Run it locally

Claude Code

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

Claude Desktop, Cursor, Windsurf and other clients

Add the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):

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

VS Code

json
{  "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 extension

Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.

Docker

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

Tools

ToolDescription
bing_searchQuery Bing Search via API and retrieve structured organic results (title, link, snippet, position).
brave_imagesSearch Brave Images via API and retrieve structured image results with pagination and SafeSearch.
brave_searchSearch Brave Search via API and retrieve structured organic results with pagination.
brave_videosSearch Brave Videos via API and retrieve structured video results with pagination and SafeSearch.
duckduckgo_searchQuery DuckDuckGo via API and retrieve structured organic results with region and language.
finder_google_countriesSearch Google countries and retrieve country codes (free Finder endpoint).
finder_google_languagesSearch Google languages and retrieve language codes (free Finder endpoint).
finder_google_locationsFind supported Google locations and retrieve location IDs and country codes (free endpoint).
google_imagesSearch Google Images via API and retrieve image results (URLs, titles, sources, dimensions).
google_jobsScrape Google Jobs results via API and retrieve structured job listings with title, company, location, and pagination.
google_mapsSearch Google Maps via API and retrieve structured place results (address, website, phone).
google_newsSearch Google News via API and retrieve structured news results with pagination.
google_searchScrape Google Search results via API and retrieve structured SERP data with pagination.
google_search_aiQuery Google AI Mode via API. JSON with text_blocks, references, and shopping_results.
google_search_autocompleteGet Google Search autocomplete suggestions via API for a given query.
google_search_lightScrape lightweight Google Search results via API: fast, cost-efficient, organic results only.
google_shoppingScrape Google Shopping results via API and retrieve structured product listings with prices, ratings, and merchant data.
google_videosSearch Google Videos via API and retrieve structured video results with metadata.
searchOne call walks engines in order and returns the first organic results. engines=auto tries Google, then Brave, Bing, DuckDuckGo, Yahoo, and Baidu. Omitted gl is us and omitted hl is en. There is no pa…
statsInfrastructure health for an engine or endpoint over the last hour. Not scoped to your account or tenant. Enabled per account: HTTP 403 means contact support to activate it.
usageRetrieve real-time usage statistics and credit balance for your Autom account.
yahoo_searchQuery Yahoo via API and retrieve structured organic results with country and language.

Every tool that calls the API consumes credits. JSON results are returned as text; images are returned inline and other files (PDF…) as embedded resources, up to 4 MB.

Streamable HTTP

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

The endpoint is POST /mcp (stateless, JSON responses). Each client sends its own key in the x-api-key header (or Authorization: Bearer <key>); the server never uses a key of its own. It binds to 127.0.0.1 by default and rejects browser origins unless you allow them — put it behind TLS before exposing it.

createHttpHandler() is exported for Fetch-compatible runtimes (Cloudflare Workers, Deno, Bun):

ts
import { createHttpHandler } from "@automdev/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

Security

  • The API key is read from AUTOM_API_KEY (stdio) or the request headers (HTTP) and removed from error messages.
  • Content fetched from websites is untrusted: the server instructions tell the model to treat it as data, not instructions.
  • See SECURITY.md to report a vulnerability.

Development

sh
npm installnpm testnpm run buildnpx @modelcontextprotocol/inspector node dist/stdio.js

Built on the SDK

The server uses the official Node.js SDK (@automdev/sdk).

All Autom SDKs

SDKPackageInstall
Node.js@automdev/sdknpm install @automdev/sdk
Pythonautomdevpip install automdev
Goautom-gogo get github.com/automdev/autom-go
.NETAutomdotnet add package Autom
Rubyautomgem install autom
PHPautom/sdkcomposer require autom/sdk
Javaautom-javabuild from source, see its README
CLI@automdev/clinpm install -g @automdev/cli
MCP server@automdev/mcpnpx -y @automdev/mcp

License

MIT — see LICENSE.

来源：README.md，提交 3cc6bf8

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.1.0最新Nov 7, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分