Stophy

Stophy MCP

AI エージェント向けのウェブスクレイピング API を、MCP サーバーとして提供します。ウェブ検索、人々の意見の閲覧、商品、場所、求人、住宅の検索を 1 つの API で行えます。料金は回答した分だけです。エージェントは 3 つの MCP ツールを通じて、Stophy のすべてのエンドポイントにアクセスできます。

ホスト型サーバーへの接続

ほとんどのアプリは、ホスト型サーバーに直接接続できます。インストールは不要です。

URL	接続方法	エージェントが利用できる機能
https://api.stophy.dev/mcp	キー不要	無料利用枠内で、エンドポイント一覧の keyless: true とマークされたエンドポイント
https://api.stophy.dev/mcp	Authorization: Bearer <key> ヘッダー	すべてのエンドポイント
https://mcp.stophy.dev/mcp	ブラウザーでサインイン	すべてのエンドポイント

stophy.dev/signup で API キーを取得できます。

Claude

ウェブ版、デスクトップ版、またはモバイル版の Claude で、カスタマイズ > コネクターを開き、カスタムコネクターを追加を選択して、https://mcp.stophy.dev/mcp を貼り付けます。Claude の指示に従ってサインインしてください。

Claude Code

ブラウザーでサインインするには、サーバーを追加してから /mcp を実行し、認証を選択します。

claude mcp add --transport http stophy https://mcp.stophy.dev/mcp

API キーを使用するには：

claude mcp add --transport http stophy https://api.stophy.dev/mcp --header "Authorization: Bearer <key>"

キーなしで開始するには：

claude mcp add --transport http stophy https://api.stophy.dev/mcp

Codex

STOPHY_API_KEY 環境変数のキーを使用するには：

codex mcp add stophy --url https://api.stophy.dev/mcp --bearer-token-env-var STOPHY_API_KEY

代わりにブラウザーでサインインするには、サインイン URL を追加してからログインします。

codex mcp add stophy --url https://mcp.stophy.dev/mcp
codex mcp login stophy

Cursor

ブラウザーでサインインするには、上のAdd to Cursorボタンを使用します。キーを使用するには、.cursor/mcp.json に次の内容を追加します。

{
  "mcpServers": {
    "stophy": {
      "url": "https://api.stophy.dev/mcp",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

キーなしで開始するには、headers を省略します。

ローカルサーバーとして実行する

ローカル MCP サーバーの起動のみ可能なアプリもあります。その場合は、このパッケージを使用してください。お使いのコンピューター上で実行され、すべてのリクエストをホスト型サーバーに転送するため、常に同じツールを利用できます。

npx -y @stophy/mcp

STOPHY_API_KEY を設定すると、エージェントはすべてのエンドポイントを利用できます。設定しない場合は、無料利用枠内でキー不要のエンドポイントを利用できます。

Claude Desktop

claude_desktop_config.json に次の内容を追加してから、Claude Desktop を再起動します。

{
  "mcpServers": {
    "stophy": {
      "command": "npx",
      "args": ["-y", "@stophy/mcp"],
      "env": { "STOPHY_API_KEY": "<key>" }
    }
  }
}

キーなしで開始するには、env を省略します。

このパッケージには Node.js 18 以降が必要です。

変数	説明
STOPHY_API_KEY	Stophy API キーです。省略可能です。
STOPHY_MCP_URL	接続先のサーバーです。デフォルトは https://api.stophy.dev/mcp です。

ツール

ツール	説明
stophy_search_endpoints	タスクに適したエンドポイントとその料金を検索します
stophy_describe_endpoint	エンドポイントが受け取る入力と返す内容を表示します
stophy_call	id、input、省略可能な fields を使ってエンドポイントを実行し、JSON を返します

通常、エージェントはまず検索し、次に内容を確認してから呼び出します。エンドポイント ID は googleSearch や youtubeSearch のようなキャメルケースです。リストは results として返され、fields を指定すると、各行で指定したキーだけが残ります。各結果には、使用したクレジット数が記載されます。

対象を 1 つ指定する場合は、リンクか ID のどちらか一方を送り、両方は送らないでください。videoUrl または videoId、placeUrl または placeId、userUrl または username を指定します。対応する組み合わせはエンドポイントの説明に記載されています。

1 回の呼び出しで、そのエンドポイントに表示された料金でサイトの 1 ページ分が返されます。ほとんどの呼び出しは 1 クレジット、一部は 2 クレジット、長いリストは結果 10 件ごとに 1 クレジットです。リストを返すエンドポイントの中には page を受け取り、page を返すものがあります。次の番号を指定し、results が空になったら停止してください。それ以外のエンドポイントは、続きがある場合に cursor を返します。次のページを取得するには、その値を変更せずに cursor として渡してください。

ネットワークと認証情報

• ホスト型サーバーは https://mcp.stophy.dev/mcp（サインインが必要）と https://api.stophy.dev/mcp（キー不要、または API キーを使用）で稼働しています。クライアントはこれらの宛先にのみリクエストを送信します。
• 認証情報：MCP クライアントが処理するブラウザーサインイン、または任意の STOPHY_API_KEY を自分で設定します。ローカルパッケージは任意の STOPHY_MCP_URL も読み込みます。
• プラグインマニフェスト（.mcp.json、.grok-plugin/plugin.json、mcp.json、plugin.json）はホスト型サーバーのみを参照します。お使いのマシン上でコードを実行することはありません。
• テレメトリーはありません。

詳細

• Stophy のドキュメント
• ダッシュボードと API キー

ライセンス

MIT