Autom

Autom MCP サーバー

Autom SERP API の公式 Model Context Protocol サーバーです。

Google、Bing、Brave の検索結果を構造化 JSON で取得できます。ウェブ、マップ、ニュース、ショッピング、画像、求人、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	1 回の呼び出しでエンジンを順番に検索し、最初に見つかったオーガニック検索結果を返します。engines=auto の場合は Google、Brave、Bing、DuckDuckGo、Yahoo、Baidu の順に試します。gl を省略すると us、hl を省略すると en になります。pa…
stats	過去 1 時間のエンジンまたはエンドポイントのインフラストラクチャの稼働状況です。アカウントやテナントごとのデータではありません。アカウントごとに有効化されます。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 の背後に配置してください。

Fetch 互換ランタイム（Cloudflare Workers、Deno、Bun）向けに createHttpHandler() がエクスポートされています。

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

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

セキュリティ

• API キーは AUTOM_API_KEY（stdio）またはリクエストヘッダー（HTTP）から読み取られ、エラーメッセージから削除されます。
• Web サイトから取得したコンテンツは信頼できないため、サーバーの指示では、モデルに対してそれを指示ではなくデータとして扱うよう伝えています。
• 脆弱性の報告については、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	パッケージ	インストール
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 をご覧ください。