SERPHouse MCP

---

目次

• SERPHouse MCP を選ぶ理由
• クイックスタート（ホスト版）
• 認証
• 質問できる内容
• ツールの概要
• ローカルでセルフホスト
• Docker でセルフホスト
• ローカルの Llama モデル（Ollama）で使用
• トラブルシューティング
• コントリビューション
• ライセンス

---

SERPHouse MCP を選ぶ理由

21 個の MCP ツール	Google、Bing、Yahoo のリアルタイム SERP、Google の各種検索、アカウント照会を、型付きスキーマですべて提供します
つなぎ込みコード不要	アシスタントが適切なツールを選択します。必要なことを自然な言葉で説明するだけです
ホスト版またはセルフホスト版	マネージドエンドポイント https://mcp.serphouse.com/mcp を利用するか、自社のインフラストラクチャでサーバーを実行できます
コンテキストを内蔵	MCP リソース（serphouse_capabilities、serphouse_constraints、serphouse_examples）が、AI に使い方のルールを自動的に伝えます

---

クイックスタート（ホスト版）

最も手早く始められる方法です。ビルドも、サーバーの保守も不要です。

1. SERPHouse ダッシュボードから API キーを取得します。

2. ヘッダーベースまたはURL ベースの認証を使って、MCP クライアントの設定にサーバーを追加します（詳しくは認証を参照してください）。

ヘッダー（推奨）：

{
  "mcpServers": {
    "serphouse": {
      "url": "https://mcp.serphouse.com/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

URL パス：

{
  "mcpServers": {
    "serphouse": {
      "url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

3. チャットを始めます。Google、Bing、Yahoo の検索、場所の検索、求人情報の取得、アカウントの確認などをアシスタントに依頼すると、適切なツールが選択されます。

ワンクリックでインストール： 上記の Install in VS Code または Install in Cursor バッジを使い、プレースホルダーの API キーを自分のキーに置き換えてください。

---

認証

サーバーでは、SERPHouse API キーを 2 つの方法で受け付けます。お使いの MCP クライアントに合った方法を選択してください。

方法	エンドポイント	キーの渡し方
ヘッダー（推奨）	POST /mcp	リクエストヘッダー SERPHOUSE_API: <api_key>
URL パス	POST /{apiKey}/mcp	URL パスにキーを埋め込みます

キーがなくてもツールとリソースを検出できます。API キーが必要なのは、SERPHouse API ツールを呼び出す場合のみです。

オプション A：ヘッダー（推奨）

カスタムヘッダーに対応した MCP クライアントに最適です。キーが URL やサーバーのアクセスログに残りません。

{
  "mcpServers": {
    "serphouse": {
      "url": "https://mcp.serphouse.com/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

セルフホストの例：

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

オプション B：URL パス

クライアントが URL のみをサポートし、カスタムヘッダーを送信できない場合に便利です。

{
  "mcpServers": {
    "serphouse": {
      "url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

セルフホストの例：

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

注： URL ベースの認証では、API キーがリクエストパスに含まれるため、プロキシログやブラウザー履歴に残ることがあります。可能であれば、ヘッダー方式を使用してください。

---

できること

AI ワークフロー内でリアルタイムの検索データを必要とする SEO チーム、代理店、SaaS マーケター向けです。ダッシュボードやスクリプト、作業の切り替えは必要ありません。

利用目的	プロンプトの例
ランキングを追跡する	「Google US のデスクトップで、『crm software』の検索順位は何位ですか？」
競合に勝つ	「ロンドンで、『project management software』の検索結果上位 5 件を占めているのは誰ですか？」
ローカル検索で存在感を高める	「シカゴで、『emergency plumber』の Google ローカル検索結果上位を教えてください。」
キーワードを見つける	「『best saas for』に対して、オートコンプリートでは何が提案されますか？」
掲載順位を監視する	「NYC でブランド名をモバイル版 Bing SERP で確認し、順位を報告してください。」
複数の検索エンジンをカバーする	「『electric vehicles』のニュース検索結果を Yahoo と Google で比較してください。」

---

ツールの概要

サーバーは、5 つのカテゴリにわたって 21 個のツールを公開します。Google と Bing の SERP リクエストでは、loc（例：Austin,Texas,United States）または loc_id（serphouse_location_search から取得）のいずれか 1 つのロケーションフィールドが必須です。両方を指定したり、どちらも省略したりしないでください。Yahoo の SERP ツールではロケーションは不要です。

リファレンス

ツール	説明
serphouse_domain_list	対応している Google、Bing、Yahoo の検索ドメイン
serphouse_language_list	検索エンジンの種類別の言語コード
serphouse_location_search	都市名や国名を loc_id に解決
serphouse_account_info	アカウント残高と使用状況

Google SERP

ツール	説明
serphouse_google_web	Google ウェブ検索
serphouse_google_image	Google 画像検索
serphouse_google_news	Google ニュース検索
serphouse_google_shop	Google ショッピング検索
serphouse_serp_google_advanced	拡張パラメーターに対応した高度な Google SERP（最大 100 件の結果）

Bing SERP

ツール	説明
serphouse_bing_web	Bing ウェブ検索
serphouse_bing_image	Bing 画像検索
serphouse_bing_news	Bing ニュース検索

Yahoo SERP

ツール	説明
serphouse_yahoo_web	Yahoo ウェブ検索
serphouse_yahoo_image	Yahoo 画像検索
serphouse_yahoo_news	Yahoo ニュース検索

Google の各種検索

ツール	説明
serphouse_google_jobs	Google 求人検索
serphouse_google_autocomplete	Google オートコンプリートの候補
serphouse_google_videos	Google 動画の検索結果
serphouse_google_short_videos	Google ショート動画（Shorts）
serphouse_google_forums	Google フォーラムの検索結果
serphouse_google_local	Google ローカル／マップの検索結果

---

ローカルでセルフホストする

マシン上でサーバーを実行して、完全に制御したり、ローカルで開発したりできます。

git clone https://github.com/SERPHouse/serphouse-mcp.git
cd serphouse-mcp
npm install
npm run build
npm start

サーバーは http://localhost:3000 でリッスンします。MCP エンドポイント：

• POST /mcp — SERPHOUSE_API ヘッダーで API キーを渡します
• POST /{apiKey}/mcp — URL パスで API キーを渡します

ローカルインスタンスを MCP クライアントに指定します（どちらの方法についても［認証］(#authentication)を参照してください）。

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

または URL ベースの認証を使用します：

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

コマンド

コマンド	説明
npm run build	TypeScript を dist/ にコンパイルします
npm start	HTTP サーバーを実行します（http://localhost:3000/mcp）
npm run start:stdio	stdio トランスポートサーバーを実行します（ローカル MCP プロセスモード）
npm run dev	ホットリロード付きで HTTP サーバーを実行します
npm run dev:ins	デバッグ用に stdio サーバーに対して MCP Inspector を起動します
npm run typecheck	ファイルを出力せずに型チェックします

ヘルスチェック：GET http://localhost:3000/health

サーバーオプション

変数	デフォルト	説明
PORT	3000	HTTP リッスンポート
HOST	0.0.0.0	HTTP バインドアドレス

認証では、ヘッダーと URL パスの両方を使用できます。［認証］(#authentication)を参照してください。

---

Docker でセルフホストする

Node.js をインストールせずに、Docker で MCP サーバーをローカル実行します。

docker compose up -d

サーバーは http://localhost:3000/mcp（ヘッダー認証）または http://localhost:3000/{apiKey}/mcp（URL 認証）で実行されます。

［認証］(#authentication)にあるいずれかの方法で、MCP クライアントを接続します：

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

または：

{
  "mcpServers": {
    "serphouse": {
      "url": "http://localhost:3000/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

---

ローカルの Llama モデル（Ollama）で使用する

SERPHouse MCP Server をローカルの Llama モデル（例：Llama 3.1 または 3.2）に接続するには、ollmcp を使用します。これは、リアルタイムの検索エンジン機能をローカルの LLM ワークフローに直接取り入れる、対話型ターミナル UI クライアントです。

前提条件

要件	備考
ツール呼び出し対応の Llama モデル	Ollama 経由でインストールし、実行している、ツール呼び出しに対応したモデル（例：llama3.1、llama3.2）
Python 3.10+	ollmcp ターミナルクライアントの実行に必要です
Node.js	npx 経由で SERPHouse MCP サーバーを実行するために必要です

1. ollmcp をインストールする

ollmcp は Python クライアントです。pip を使ってグローバルにインストールします：

pip install --upgrade ollmcp

2. config.json ファイルを作成する

クライアントが SERPHouse サーバーへの接続方法と API 認証情報の渡し方を把握できるよう、設定プロファイルが必要です。［認証］(#authentication)にあるいずれかの認証方法を使って、作業フォルダーに config.json を作成します：

{
  "mcpServers": {
    "serphouse-mcp": {
      "url": "https://mcp.serphouse.com/mcp",
      "headers": {
        "SERPHOUSE_API": "YOUR_SERPHouse_API_KEY"
      }
    }
  }
}

または URL ベースの認証を使用します：

{
  "mcpServers": {
    "serphouse-mcp": {
      "url": "https://mcp.serphouse.com/YOUR_SERPHouse_API_KEY/mcp"
    }
  }
}

YOUR_SERPHouse_API_KEY を、［SERPHouse Dashboard］(https://www.serphouse.com)で取得した有効なキーに置き換えてください。

3. ターミナルクライアントを実行する

設定プロファイルと対象のモデルを指定して、対話型インターフェースを起動します：

ollmcp --servers-json config.json --model llama3.1

ターミナル UI が読み込まれたら：

1. モデル一覧から対象の Llama モデルを選択します。
2. ライブのウェブデータが必要なプロンプトを送信します。例：「SERPHouse を使って、『best developer tools』の Google 検索上位結果を調べてください。」
3. ローカルの Llama モデルが SERPHouse ツールを呼び出し、リアルタイムの SERP データを会話形式の回答に変換する様子を確認します。

互換性のあるモデル

以下の Ollama モデルは、ツールの使用に適しています：

• gemma4
• qwen3.5
• lfm2.5-thinking
• llama3.2
• mistral

ツール使用に対応した Ollama モデルの一覧については、公式の［Ollama models］(https://ollama.com/search?c=tools)ページをご覧ください。

ツールから返された画像も処理できるモデルについては、Ollama の［vision models］(https://ollama.com/search?c=vision)ページをご覧ください。

---

トラブルシューティング

問題	対処方法
API キーが見つからない	POST /mcp に SERPHOUSE_API ヘッダーを送信するか、URL パスにキーを指定して POST /{apiKey}/mcp を使用してください
無効なキー	SERPHouse dashboard でキーを確認してください
クレジットを使い切った	serphouse_account_info で残高を確認してください
ロケーションエラー	Google と Bing のツールでは、loc または loc_id のどちらか一方を含めてください。両方は指定しないでください。ID の解決には serphouse_location_search を使用してください。Yahoo SERP ツールではロケーションは不要です。
接続が拒否された	サーバーが実行中で、URL とポートが正しいことを確認してください

---

貢献

貢献を歓迎します。変更内容を絞り込み、既存のコードスタイルに合わせてください。

git checkout -b feature/your-feature
npm install
# make changes
npm run typecheck
git commit -m "Add your feature"
git push origin feature/your-feature

次に、プルリクエストを作成してください。セットアップや設定を変更した場合は、この README を更新してください。

---

ライセンス

MIT License — Copyright SERPHouse.