GoAnyAPI MCP

English | 日本語

Model Context Protocol（MCP）を通じて、GoAnyAPI のウェブサイトデータと検索機能を AI クライアントに接続します。接続後、自然言語でウェブサイトのトラフィック、ドメイン評価、被リンク、SERP、オートコンプリートなどのデータを直接照会でき、AI が質問に応じて適切なツールを選択します。

はじめに

1. API キーの取得

1. goanyapi.com にログインします。

2. コンソールの API キーページで API キーを作成してコピーします。

3. アカウントに利用可能なクレジットがあることを確認します。

API キーは、ご自身の環境変数またはクライアントのシークレット管理にのみ保存し、コードリポジトリ、スクリーンショット、公開設定ファイルにコミットしないでください。

2. API キーの設定

macOS / Linux：

export GOANYAPI_API_KEY="你的 GoAnyAPI API Key"

Windows PowerShell：

$env:GOANYAPI_API_KEY="你的 GoAnyAPI API Key"

上記の書き方は現在の PowerShell ウィンドウにのみ有効です。Windows のユーザー環境変数として永続的に有効にする場合は、次を使用できます：

[Environment]::SetEnvironmentVariable("GOANYAPI_API_KEY", "你的 GoAnyAPI API Key", "User")

永続的な環境変数を設定した後は、ターミナルを開き直し、Codex、Claude Code、Cursor を再起動する必要があります。すでに実行中のクライアントは新しい環境変数を自動的に読み取りません。

AI クライアントにターミナル操作権限がある場合は、会話を通じて API キーの環境変数を設定することもできます。例：

请将我提供的 GoAnyAPI API Key 设置为当前 Windows 用户的持久环境变量 GOANYAPI_API_KEY。
请不要在回复中回显 API Key，也不要把它写入项目文件、MCP 配置文件或 Git 仓库。
设置完成后，仅验证环境变量已存在，然后帮我检查 goanyapi MCP 配置。

API キーは、クライアントの安全な入力またはローカルのシークレットマネージャーを通じて提供し、公開の会話に直接貼り付けないでください。会話形式の設定には、ターミナルと環境変数の操作に対するユーザーの承認が必要です。

3. MCP サービスアドレス

正式な MCP サービスアドレス：

https://mcp.goanyapi.com/mcp

サービスは Bearer Token 認証を使用します。クライアントは次を送信する必要があります：

Authorization: Bearer <GOANYAPI_API_KEY>

Related MCP server: SE Ranking MCP Server

AI クライアントへの接続

会話による設定

AI クライアントにターミナルと設定ファイルの操作権限がある場合は、会話を通じて MCP 接続を完了できます。Codex に限りません。たとえば、会話形式の操作をサポートする AI クライアントで次を送信します：

请帮我接入 GoAnyAPI MCP。
服务地址：https://mcp.goanyapi.com/mcp
认证方式：从环境变量 GOANYAPI_API_KEY 读取 Bearer Token。
请根据当前 AI 客户端的 MCP 配置格式完成配置，验证 goanyapi 已启用，并且不要把真实 API Key 写入配置文件。

会話形式の設定には、ターミナルと設定ファイルの操作に対するユーザーの承認が必要です。設定完了後、ターミナルを開き直してクライアントを再起動し、自然言語のリクエストを送信してください。

Codex

~/.codex/config.toml に次を追加します：

[mcp_servers.goanyapi]
url = "https://mcp.goanyapi.com/mcp"
bearer_token_env_var = "GOANYAPI_API_KEY"

Codex を再起動すると使用できます。Codex は GOANYAPI_API_KEY 環境変数からキーを読み取り、認証リクエストヘッダーを自動的に追加します。

Claude Code（cc）

プロジェクトのルートディレクトリに .mcp.json を作成します：

{
  "mcpServers": {
    "goanyapi": {
      "type": "http",
      "url": "https://mcp.goanyapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${GOANYAPI_API_KEY}"
      }
    }
  }
}

Claude Code を起動したら、/mcp を実行して接続状態を確認できます。次のコマンドも使用できます：

claude mcp list

Cursor

以下の設定をプロジェクトレベルの .cursor/mcp.json または Cursor のグローバル MCP 設定ファイルに書き込みます：

{
  "mcpServers": {
    "goanyapi": {
      "url": "https://mcp.goanyapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GOANYAPI_API_KEY}"
      }
    }
  }
}

保存後、Cursor をリロードします。Cursor は GOANYAPI_API_KEY 環境変数からキーを読み取ります。

このように使用できます

接続が成功したら、AI に直接質問してください。例：

查询 github.com 的网站流量和主要流量来源。

查询 github.com 的域名评分和外链数据。

使用 Bing SERP API 搜索 ai image，返回广告、自然结果和分页信息。

查询 ai image 的 Google 和 Bing Autocomplete 建议词。

MCP はリクエストに応じて対応する GoAnyAPI ツールを選択します。詳細なパラメータ、返却フィールド、クレジット消費については、GoAnyAPI 中国語ドキュメント を参照してください。

料金とデータセキュリティ

• 呼び出しのたびに、対応する API のルールに従ってアカウントのクレジットが消費されます。

• API キーはお客様の GoAnyAPI アカウント権限を表します。他人と共有しないでください。

• 実際の API キーを Git リポジトリ、プロジェクトのコミット履歴、公開スクリーンショットに書き込まないでください。

• 特定のクライアントを今後使用しない場合は、その中の MCP 設定を削除し、API キーをローテーションすることをお勧めします。

よくある質問

401 が返される、または未認証のメッセージが表示される

API キーが有効であることを確認し、クライアントが次を正しく送信しているか確認してください：

Authorization: Bearer <GOANYAPI_API_KEY>

また、クライアントの起動前に GOANYAPI_API_KEY 環境変数が設定されていることを確認してください。

クレジット不足が返される

GoAnyAPI 請求ページ にログインして、アカウント残高を確認し、クレジットをチャージしてください。

クライアントにツールが表示されない

MCP アドレスが完全に次のように入力されていることを確認してください：

https://mcp.goanyapi.com/mcp

その後、対応するクライアントを再起動または再読み込みし、MCP の接続状態を確認してください。

サービスにアクセスできることを確認する方法

ブラウザまたはコマンドラインでヘルスチェックアドレスにアクセスできます：

https://mcp.goanyapi.com/health

ヘルスチェックはサービスの稼働確認のみを目的としています。具体的なツールを呼び出すには、引き続き有効な API キーが必要です。

Windows サンドボックスがネットワークリクエストをブロックする

手動テスト中に次のようなエラーが表示された場合：

curl: (7) Failed to connect to mcp.goanyapi.com port 443

これは通常、現在のターミナルまたは AI クライアントのサンドボックスが送信ネットワークアクセスを禁止していることを意味し、MCP アドレスや API キーの設定エラーではありません。まずクライアントを再起動して、クライアントの MCP マネージャーに設定を再読み込みさせてください。それでも失敗する場合は、プロキシ、ファイアウォール、または企業ネットワークがアクセスを許可しているか確認してください：

mcp.goanyapi.com:443

テストのためにサンドボックスの制限をすべて無効にしないでください。クライアントが提供するネットワークホワイトリストまたは制御されたネットワーク権限を使用して、必要なドメインへのアクセスのみを許可してください。

PowerShell に Web スクリプトのセキュリティ警告が表示される

Windows PowerShell 5.1 で Invoke-WebRequest を使用して MCP をリクエストすると、Web スクリプトの実行確認を求めるプロンプトが表示される場合があります。これは PowerShell の Web パーサーによるプロンプトであり、GoAnyAPI の MCP エラーではありません。手動テストでは次を使用できます：

Invoke-WebRequest -UseBasicParsing ...

または、Invoke-RestMethod / curl.exe に切り替えて、Web スクリプトパーサーの使用を避けてください。MCP が JSON を返す場合は、Invoke-RestMethod の使用をお勧めします。

設定変更後にクライアントの再起動は必要ですか

MCP 設定ファイルまたは環境変数を変更した後、クライアントは設定を再読み込みする必要があります。一部のクライアントは再接続やホットリロードをサポートしていますが、MCP サービスと API キーの両方が有効になっていることを確認するには、通常、完全に終了してからクライアントを開き直すことをお勧めします：

• Codex：Codex を再起動します。

• Claude Code：新しいセッションを開始し、/mcp を使用して接続状態を確認します。

• Cursor：ウィンドウを再読み込みするか、Cursor を再起動します。

• その他の AI クライアント：クライアントが提供する Reload、Reconnect、Restart 機能を優先的に使用してください。

それでもクライアントにツールが表示されない場合は、MCP アドレス、環境変数、認証設定に誤りがないことを確認してから、クライアントを再読み込みまたは再起動してください。