SearchAtlas

SearchAtlas MCP サーバー

npm · MCP Registry · GitHub

MCP 対応の AI クライアントを、SearchAtlas v2 MCP サーバーに接続します。OTTO SEO、PPC、Content Genius、Site Explorer、Google Business Profile、Local SEO、Link Laboratory、Digital PR、LLM Visibility、キーワード調査などを網羅した 500 以上のツールを利用できます。

このパッケージは、ホスト型の v2 MCP サーバー https://mcp.searchatlas.com/mcp/ への軽量な stdio ブリッジとして動作するため、stdio のみを扱うクライアントでも利用できます。Streamable-HTTP にネイティブ対応したクライアントは、リモートエンドポイントに直接接続できます。

Claude Code、Cursor、Claude Desktop、VS Code、Windsurf、Zedで利用できます。

セットアップ（3 ステップ）

1. インストールしてログインする

npm を使用する場合：

npm install -g searchatlas-mcp-server
searchatlas login

yarn を使用する場合：

yarn global add searchatlas-mcp-server
searchatlas login

pnpm を使用する場合：

pnpm add -g searchatlas-mcp-server
searchatlas login

インストールせずに使用する場合（npx）：

npx searchatlas-mcp-server login

ブラウザーが開きます。ログインしたら、次の手順に進みます。

1. F12（Mac の場合は Cmd+Option+I）を押して DevTools を開きます
2. Console タブを開きます
3. 次を実行します：localStorage.getItem("token")
4. 結果をコピーして、ターミナルに貼り付けます

CLI がトークンを検証して保存し、パスを自動検出した、すぐに貼り付けて使える設定を表示します。

2. MCP クライアントに追加する

Claude Code

macOS / Linux：

claude mcp add searchatlas -e SEARCHATLAS_TOKEN=your-token -- npx -y searchatlas-mcp-server

Windows（PowerShell）：

claude mcp add searchatlas -e SEARCHATLAS_TOKEN=your-token -- npx.cmd -y searchatlas-mcp-server

Windows に関する注意： npx の代わりに npx.cmd を使用する必要があります。Claude Code はプロセスを直接起動し、Windows では .cmd 拡張子が必要なためです。

これで完了です。

Cursor

プロジェクトのルートに .cursor/mcp.json を作成します（グローバルに設定する場合は ~/.cursor/mcp.json）。

{
  "mcpServers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

パスは環境によって異なる場合があります。 which node と npm root -g を実行して確認するか、searchatlas login が表示した設定をコピーしてください。設定には正確なパスが記載されています。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

保存した後、Claude Desktop を再起動してください。

{
  "mcpServers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

{
  "servers": {
    "searchatlas": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
      "env": {
        "SEARCHATLAS_TOKEN": "your-token"
      }
    }
  }
}

{
  "context_servers": {
    "searchatlas": {
      "command": {
        "path": "/opt/homebrew/bin/node",
        "args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
        "env": {
          "SEARCHATLAS_TOKEN": "your-token"
        }
      }
    }
  }
}

3. 動作を確認する

searchatlas check

  SearchAtlas MCP Server — Health Check

  ✓ Credential source: ~/.searchatlasrc
  ✓ Config loaded successfully (endpoint: https://mcp.searchatlas.com/mcp)
  ✓ JWT structure valid (expires in 12 days) — user 42
  ✓ MCP handshake succeeded — 587 tools available

  All checks passed — you're ready to go!

なぜフルパスが必要なのか

macOS の GUI アプリ（Cursor、Claude Desktop、VS Code、Windsurf、Zed）は、シェルの PATH を引き継がないため、node や npx を見つけられません。node のフルパスを指定し、インストール済みのパッケージを直接指定すると、spawn npx ENOENT や env: node: No such file のエラーを完全に回避できます。

searchatlas login はパスを自動検出し、コピーして貼り付けられる設定を表示します。

使い方

自然な言葉で話しかけるだけです。AI が適切なツールを選択します。

"What are the top SEO issues for my site?"
"Run a technical SEO audit on example.com"
"Write a blog post about technical SEO best practices"
"Find long-tail keywords for project management software"
"List my projects"
"Show available playbooks and run one"

CLI コマンド

すべてのコマンドは npx searchatlas-mcp-server <command> でも実行できます。

ツール

ツールはホストされている v2 MCP サーバーから動的に検出されるため、新しいツールが追加されてもパッケージを更新することなく、クライアントには最新のカタログ（現在約 587 個のツール）が表示されます。主なグループは次のとおりです。

searchatlas check を実行すると最新の件数を確認できます。または、接続後に MCP クライアントにツールを一覧表示するよう依頼してください。

設定

トークンの優先順位（最初に一致したものを使用）

1. SEARCHATLAS_TOKEN 環境変数
2. SEARCHATLAS_API_KEY 環境変数
3. ~/.searchatlasrc ファイル（searchatlas login によって作成）

環境変数

Streamable HTTP 対応のネイティブクライアント

MCP クライアントが Streamable HTTP を直接サポートしている場合は、この npm パッケージを省略して、リモートサーバーに 1 ステップで接続できます。

• URL：https://mcp.searchatlas.com/mcp/
• トランスポート：Streamable HTTP（JSON-RPC + SSE）
• ヘッダー：Authorization: Bearer <SEARCHATLAS_TOKEN>

トラブルシューティング

まだ解決しませんか？ searchatlas check を実行し、Node.js >= 18（node --version）を確認するか、イシューを作成してください。

開発

git clone https://github.com/Search-Atlas-Group/searchatlas-mcp-server.git
cd searchatlas-mcp-server
npm install && npm run build

MCP Inspector でテストします。

npx @modelcontextprotocol/inspector npx searchatlas-mcp-server

Requirements

• Node.js >= 18
• A SearchAtlas account — sign up here

License

MIT