TheSEO

theseo-mcp

TheSEO が提供するオープンソースのリモート MCP サーバーです。TheSEO は、可視性を専門とする組織です。私たちが調べた限りでは、オランダのマーケティング会社が提供する初の MCP サーバーです。

MCP（Model Context Protocol）は、Claude などの AI アシスタントが外部ツールを利用できるようにするオープン標準です。このサーバーを一度追加するだけで、AI が SEO スキャンを実行したり、ローカルでの検索の見つかりやすさを確認したり、無料の Claude スキルを検索したり、企業の頭脳テンプレートを取得したり、独自の AI-Index に問い合わせたりできます。このサーバーが提供する機能はすべて無料で、アカウントも不要です。

サーバーは Streamable HTTP トランスポートを使用する Cloudflare Worker として動作します。

エンドポイント： https://mcp.theseo.nl/mcp

mcp.theseo.nl では、これらのツールに加え、TheSEO プラットフォームのツールも利用できます。モデルごとの AI 可視性（ai_zichtbaarheid_merk）、業界ごとのギャップ分析（ai_index_gat）、AI クローラーチェック（ai_crawler_check）、出典付きのオランダの業界規則（vakregels）、さらにアカウントがあれば、メモリー、タスク、プレミアムスキルも利用できます。説明とインストール方法については、mcp.theseo.nl をご覧ください。seo_scan と lokale_vindbaarheid_check は、背後のサイトフローでリード情報を収集するため、現在はそちらでは無効になっています。これらのツールは、独立したサーバー https://theseo-mcp.sales-cc8.workers.dev/mcp では利用できます。

このリポジトリにある7つのツール

1. seo_scan

技術、オンページ、コンテンツ、AI 対応の4カテゴリにわたる24項目について、URL をスキャンします。theseo.nl の無料 SEO スキャンと同じスキャナーです。

呼び出し例：

「https://voorbeeld.nl の SEO スキャンを実行して、主な問題点をまとめてください。」

{ "url": "https://voorbeeld.nl" }

カテゴリごとのスコア（0〜100）と、各項目について、良い点や問題点を率直に説明した内容が得られます。

2. lokale_vindbaarheid_check

Google マップで企業がどれだけ見つかりやすいかを確認します。Google ビジネスプロフィールが存在するか、営業時間、写真、評価、レビュー、ウェブサイト、電話番号が整っているかを調べます。ローカル検索での見つかりやすさチェッカーと同じチェックです。

呼び出し例：

「ユトレヒトのベーカリー、Bakkerij Jansen のローカル検索での見つかりやすさを確認してください。」

{ "bedrijfsnaam": "Bakkerij Jansen", "stad": "Utrecht" }

スコアには、実際に測定できた項目のみが反映されます。測定できない項目は「未測定」として返され、「不十分」と判定されることはありません。

3. skill_zoeken

theseo.nl の無料のオランダ語 Claude スキルのカタログ全体から、トピックに基づいて検索します。各検索結果には、名前、説明、解説ページ、ZIP ファイルの直接ダウンロード URL が含まれます。

カタログには2種類のスキルがあります。skills-hub の思考、執筆、コーチング向けスキルと、記事に関連する専門スキル（職業別のローカル SEO、リンク構築、WordPress、Google Ads）です。正確な数は src/catalogus.json の aantal に記載されており、内訳は aantal_hub と aantal_artikel に記載されています。

呼び出し例：

「SWOT 分析を手伝ってくれる無料のスキルはありますか？」

{ "onderwerp": "swot analyse", "max": 5 }

4. bedrijfsbrein_template

無料の企業の頭脳テンプレートの全内容を返します。AI に自社について学習させるための、記入式の bedrijfsbrein.md コンテキストファイルです。会話の中でテンプレートに直接記入する際に便利です。

呼び出し例：

「企業の頭脳テンプレートを取得して、私の塗装会社向けに記入してください。」

このツールにパラメーターはありません。

5. ai_index_branche

業界ごとに、独自の AI-Index で測定した内容を返します。有効な測定数、モデルが回答を拒否した回数とその理由（モデルの表現をそのまま記載）、最も多く言及された企業上位10社、結果の集中度が含まれます。

{ "branche": "logistiek" }

6. ai_index_vragen

業界ごとに、モデルに尋ねる質問の原文と測定方法を返します。これにより、測定を自分で再現できます。

{ "branche": "horeca", "max": 5 }

7. ai_index_bedrijf

企業名が測定データに含まれているか、含まれている場合はどの業種や質問に登場するかを検索します。名前が含まれていない場合、このツールは明確に「判断を示すものではない」と伝えます。固定された質問票を使ったサンプル調査だからです。

{ "bedrijfsnaam": "bol.com" }

3つのツールすべてで、同じ出典情報を最後に表示します。モデル、測定回数、最終測定日、ライセンス CC BY 4.0、完全版の説明書へのリンクです。経時的な傾向や訪問者数については述べません。測定は temperature 1 で行われているため、測定時点による違いはサンプリングノイズでもあります。

インストール

Claude（claude.ai とデスクトップアプリ）

1. 「設定」を開き、「コネクター」を選択します。
2. 「コネクターを追加」を選び、URL を貼り付けます：https://mcp.theseo.nl/mcp
3. これで完了です。たとえば、サイトの SEO スキャンを Claude に依頼できます。

Claude Code

claude mcp add --transport http theseo https://mcp.theseo.nl/mcp

Cursor

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加します：

{
  "mcpServers": {
    "theseo-mcp": {
      "url": "https://mcp.theseo.nl/mcp"
    }
  }
}

正直な制約

• SEO スキャンでは、1 ページについて自動測定可能な 24 項目を確認します。最初の印象を得るのには適していますが、完全な監査ではありません。本格的な監査では、複数のページ、競合、キーワード、検索意図を確認します。これは引き続き手作業で行う必要があります。
• 見つけやすさのチェックでは、Google Places API で測定可能な項目を確認します。ローカルマップ枠での順位など、測定できない基準は「未測定」と明示して返され、スコアには含まれません。
• このチェックを利用するには、対応する API キーが TheSEO サーバーに設定されている必要があります。キーがない場合、架空の結果ではなく、API のエラーメッセージがそのまま表示されます。
• スキルカタログは、サイトの生成時点のスナップショットです。新しいスキルは、このサーバーを再デプロイすると表示されます。

保存されるデータ

• このサーバーにはデータベースもアカウントもログイン機能もありません。
• ツールを呼び出すたびに、Cloudflare Analytics Engine（データセット theseo_mcp_tool_usage）に1つのカウントポイントを書き込みます。記録されるのは、ツール名、UTC の日付、数値の 1 です。入力内容、IP アドレス、ヘッダー、会話テキストは記録しません。そのため、誰が使ったかではなく、どのツールが使われているかを把握できます。
• seo_scan と lokale_vindbaarheid_check は、入力内容を theseo.nl のサイト Worker に転送し、X-TheSEO-Kanaal: mcp ヘッダーを付けて、MCP 経由の呼び出しであることをサイトに伝えます。このサイトの処理フローでは現在、スキャンしたウェブアドレス、または企業名と所在地を、結果とともに TheSEO の CRM にリードとして保存します。サイトのフォームと同様です。そのため、この2つのツールでは readOnlyHint: false になっています。
• ほかの5つのツールは、サーバーに組み込まれたデータを読み取るだけで、データを転送しません。
• Worker のログに含まれるのは、入力内容を含まない独自のエラーメッセージだけです。Cloudflare の標準呼び出しログは無効になっています（wrangler.jsonc の invocation_logs: false）。

セルフホストまたは開発への参加

Node 20 以降が必要です。

npm install
npm test              # alle tests, in-process en zonder netwerk
npm run dev           # lokaal op http://localhost:8787/mcp
npm run check         # TypeScript-controle
npm run dry-run       # controleer de deploy zonder te deployen
npm run deploy        # deploy naar Cloudflare (eigen account nodig)

スキルカタログ（src/catalogus.json）とビジネスブレインのテンプレート（src/bedrijfsbrein.json）は、theseo.nl のサイトリポジトリから生成されます。

npm run genereer-catalogus -- /pad/naar/theseo-cloudflare-site

スクリプトは2つのソースを読み込みます。スキルハブと、public/ 内のその他すべての HTML です。ディスク上にあるもののサイト上でどこからもリンクされていない ZIP は、まだ公開されていないため、意図的に対象外となります。

メンテナンスルール。 サイトにスキル ZIP を追加した場合は、同じ日に3つすべてを同期します。サイト本体、GitHub リポジトリ claude-skills-nederlands、そしてこのカタログです。これを怠ると、スキルはダウンロード可能でも、skill_zoeken では見つかりません。実際、2026年8月11日から18日にかけてこの問題が発生しました。カタログがスキルハブだけを読み込んでいたため、記事に紐づく専門スキルがすべて見落とされていました。手順は、カタログを生成し、npm test、npm run check、npm run deploy を実行してから、コミットしてプッシュします。スキルは定期的に追加されるため、必ずデプロイの直前に生成してください。前日に生成してはいけません。

プレミアムスキルは、この公開カタログには決して含まれません。スクリプトは /skills/premium/ 配下のページをスキップします。また、ページが /skills/premium/ 配下にある、スラッグに premium という単語が含まれる、ダウンロードリンクが /assets/skills/<slug>.zip と異なる、またはプレミアムツール名が含まれるなど、いずれかの項目がプレミアムらしいと判断すると、何も書き込まずにエラーで停止します。テスト test/catalogus-premium.test.ts は、組み込みカタログとスクリプト自体に対して同じチェックを行います。

スクリプトは、スキルハブにスキルが1つも見つからない場合も、エラーで停止します。これは過剰に慎重な措置ではありません。2026年8月にこのページが検索可能なタイル形式に再構築された際、古いパターンでは何も見つからず、クラスタラベルのないカタログがスクリプトによって警告なしに書き出されました。その場合は、パターン1のパターンを調整してください。

サーバー自体にシークレットは含まれません。スキャンとチェックのロジックは theseo.nl のサイト Worker 上で動作し、この MCP サーバーはその公開エンドポイントを呼び出すだけです。

ライブラリとして使う

7つのツールは関数としても利用できるため、別の Worker が独自のツールとともに、自身の MCP サーバーに組み込めます。パッケージは registreerGratisTools(server, deps) をエクスポートします。

import { McpServer } from '@modelcontextprotocol/server';
import { maakGebruiksteller, registreerGratisTools } from 'theseo-mcp';

const server = new McpServer({ name: 'mijn-server', version: '1.0.0' });
registreerGratisTools(server, {
  site: env.SITE_WORKER, // service binding naar de site-Worker
  teller: maakGebruiksteller(env.MCP_USAGE), // optioneel
});

• グローバルバインディングはありません。すべて deps 経由で渡します。deps に不明なキーや誤ったキーがある場合、直ちに TypeError が発生します。
• サイトへの各呼び出しには、X-TheSEO-Kanaal: mcp ヘッダーが付与されます。署名などの追加ヘッダーを送信する場合は、追加ヘッダーを付与する fetch を備えた独自オブジェクトを site として渡してください。
• premiumSkills は任意です。slug、naam、zin を含むリストを指定した場合に限り、skill_zoeken はその名前もプレミアムと表示して、ダウンロードリンクなしで表示します。匿名ユーザー向けにはリストを空にしてください。このリポジトリにはプレミアムスキルは含まれていません。valideerPremiumSkills がリストを検証します。
• zod 4.4.3 と @modelcontextprotocol/server 2.0.0 は、バージョンを固定した peerDependencies です。バンドルに zod のコピーが1つだけ含まれるよう、利用する Worker 側でこれらを提供します。
• このパッケージは TypeScript ソースを提供し、JSON をインポートします。そのため、利用する Worker の tsconfig.json で resolveJsonModule を有効にする必要があります。Wrangler と Vitest はソースを直接バンドルします。

技術

• TypeScript、@modelcontextprotocol/server v2（公式 MCP TypeScript SDK）
• Cloudflare の agents。ステートレスな Streamable HTTP ハンドラーに使用します。
• Cloudflare Workers。wrangler でデプロイします。
• 実際のハンドラーに対して、公式 MCP クライアントを使ってテストします。プロセス内で実行し、ネットワークは使用しません。

ライセンス

MIT。TheSEO が作成しました。質問やアイデアがあれば、issue を作成してください。