connskill-growth-mcp について
connskill-growth-mcpは、AgentやMCPクライアント向けのキーワード・成長調査用MCPサーバーです。キーワード指標、モデル化されたAI需要、ドメイン順位、ローカル検索の確認を個別課金で提供し、x402の支出制御を備えています。
主な機能
- 01Google検索量、CPC、広告競争度
- 02モデル化されたAI質問需要
- 03ドメインのランキングキーワード
- 04ローカル検索とMapsの確認
- 05x402の購入保護
活用シーン
- 01市場別のキーワード需要比較
- 02モデル化された質問需要の確認
- 03ドメインのランキング語句の調査
- 04ローカル検索とMapsの確認
MCP 対応
サービスカタログから生成される成長調査ツールをMCPクライアントに公開します。有料呼び出しはBase上のUSDCを使うx402に対応し、無料の検出エンドポイントにはウォレットは不要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @connskill/mcp-growth-servicesX402_WALLET_KEYシークレットPrivate key (0x...) of a dedicated Base wallet holding USDC. Optional: without it only free endpoints work.X402_MAX_USDHard cap per paid call in USD (default 1.00).X402_DISCOVERY_SOURCEOptional self-reported discovery channel: github, npm, glama, mcp-registry, x402scan, 402index, x402-list, agenstry, website. Leave empty if unknown. Not verified acquisition.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
@connskill/mcp-growth-services
まず、Google Ads の検索ボリューム、CPC、広告競合度、利用可能な月別履歴を確認する Keyword Metrics から始めましょう。モデル化された質問需要のシグナルが判断に役立つ場合に限り、AI Search Volume を追加してください。これらは別々の有料結果であり、自動的にセットになるものではありません。AI 需要には Google の「他の人はこちらも質問」などのシグナルが含まれますが、ChatGPT や Perplexity の利用状況を測定したものではありません。広告競合度は、オーガニック SEO の難易度ではありません。
キーワード調査を始める · ドイツ語で始める · 手順ガイド
| 結果 | 無料の準備 | 有料 MCP ツール |
|---|---|---|
| Google のキーワード需要、CPC、広告競合度 | キーワードレシピ | keyword_metrics |
| モデル化された AI/質問需要のシグナル | データの制限と入力 | ai_search_volume |
| ドメインが順位を獲得しているキーワード | ドメインのランキング | ranked_keywords |
| ローカル検索とマップの調査結果 | ローカル市場チェック | local_market_check |
範囲を限定したキーワードタスク
- 1~10 個の語句を選び、無料のカタログで国と言語を確認します。
- 現在の料金と入力制限を確認します。各ツールと合計予算を承認します。
- 承認したツールのみを呼び出し、比較には同じ語句と市場を使用します。
{"keywords":["seo api","keyword research"],"location_code":2276,"language_code":"de"}
MCP クライアントへの指示例(準備のみ):
ドイツ語で、ドイツの以下 2 つの語句について Keyword Metrics を準備してください。現在の料金と出力フィールドを説明してください。AI Search Volume は、別個の任意のモデル化シグナルとして提示してください。私がツールと合計予算を承認するまで、どちらの結果も購入しないでください。不明なデータは不明のままにし、結果が不明確な場合は支払いを再試行しないでください。
無料のレシピやこのプロンプトは、支払いを許可するものではありません。準備段階では X402_MAX_USD=0 を維持し、ウォレットを指定しないでください。上限は呼び出しごとに適用され、合計予算ではありません。ランキングや収益は保証されません。部分的な結果や取得できない結果がないか確認してください。
その他のカタログサービスには、サイト監査、バックリンク、SMS 認証、受信専用の受信トレイ、ドイツでホストされる LLM チャット、x402 販売者チェックなどがあります。
アカウントも API キーも不要です。有料の呼び出しでは、x402 経由で Base 上の USDC を使用します。無料のエンドポイント(見積もり、カタログ、ステータス、所在地)にはウォレットは一切必要ありません。
ソースと公開パッケージ
バージョン 0.3.3 では、汎用的なツール名に明確なプレフィックスを付け、ツールの説明に重複していた「(free)」を削除しました。名前が変更されたツール:jobs/jobs_get、claim、deliver、close は board_jobs/board_jobs_get、board_claim、board_deliver、board_close に、site、site_renew、site_stats は analytics_site、analytics_site_renew、analytics_site_stats に変更されました。prose は conformance_prose、status_json は service_status、exchange は agent_exchange になりました。エンドポイント、価格、支払いの動作に変更はありません。これらのツールを名前で呼び出すクライアントは、新しい名前を使う必要があります。
バージョン 0.3.2 では、キーワードを先に示すガイドと、任意の検出チャネル測定が追加されました。
バージョン 0.3.1 では、MCP SDK と脆弱性のある推移的依存関係を更新しました。
以下で説明する v2 支払いクライアントと永続的な購入ガードを導入した 0.3.0 から、支払いプロトコルと支出ガードに変更はありません。以前の 0.2.1 をインストールしている場合は、支払いクライアントが異なります。このバージョンでこれらの安全策が使えるとは限りません。インストール前に、npm の最新バージョンと公式 MCP Registryを確認してください。バージョンを指定しない npx コマンドでは、現在の GitHub ソースではなく、npm で公開されているリリースが選択されます。このリポジトリにチェックインされているバージョンを使うには、ソースからのセットアップを利用してください。GitHub、npm、Registry、Glama はそれぞれ別のリリースチャネルです。
このリポジトリには、次の3つのエントリーポイントがあります。
| 形式 | 対象 | インストール |
|---|---|---|
MCP サーバー (index.mjs) | Claude Code、Claude Desktop、Cursor、Codex、OpenClaw、Hermes、MCP に対応するすべてのもの | 公開済みの npm パッケージ。バージョンを確認するか、ソースからセットアップしてください |
スキル (skills/connskill-growth/) | Claude Code、Codex、OpenClaw、Hermes(agentskills.io 形式) | フォルダーをコピーするか、このリポジトリからインストールしてください |
スタンドアロンスクリプト (skills/connskill-growth/scripts/x402-call.mjs) | node を実行できるすべてのエージェント | node x402-call.mjs GET /v1/local-market-check-quote(無料) |
MCP プロセスがカタログを最初に読み込む際、サービスの最新の OpenAPI カタログと x402 の価格からツールが生成されます。利用可能なツールのセットは、これらのドキュメントに従います。除外対象として指定されたエンドポイントとウォレット署名操作は、このアダプターから除外されます。更新されたカタログを読み込むには、MCP プロセスを再起動してください。
最初の購入:準備してから、支払いを有効にする
ウォレットなし、支払い無効の状態から始めます。mcpServers を受け付ける MCP クライアントでは、次の固定構成を使用してください(Node.js 22 以降):
{
"mcpServers": {
"connskill-growth": {
"command": "npx",
"args": ["-y", "@connskill/[email protected]"],
"env": { "X402_MAX_USD": "0", "X402_DISCOVERY_SOURCE": "github" }
}
}
}
- 無料のカタログ、入力内容、現在の見積もりを確認します。HTTP 402 は価格の提示であり、支払いでも、再試行して解決すべきエラーでもありません。
- ツール、入力内容、価格を確認して承認します。
X402_WALLET_KEYは、専用ウォレットに Base Mainnet 上の USDC を入れたうえで、MCP クライアントの安全なローカル設定からのみ設定してください。キーやシードをチャットに貼り付けないでください。 X402_MAX_USDを0から承認済みの呼び出しごとの金額に変更し、MCP プロセスを再起動して新しい設定を読み込ませます。ウォレットを設定しただけでは購入は承認されません。まずkeyword_metricsを1回呼び出してください。任意のai_search_volumeは別個の購入であり、その承認には含まれません。- 結果と購入参照情報を保存します。支払いが不明確な場合や結果がない場合は、ウォレットサポートを利用してください。再度支払わないでください。その後、準備のみを行うセッションでは上限を
0に戻し、再起動してください。
上限は呼び出しごとに適用されるもので、総予算でも、1回限りのカウンターでもありません。クライアント側でも、承認した範囲を強制する必要があります。クライアントやネットワークの費用が別途発生する場合があります。ホスト型 MCP では無料ツールを確認できますが、ウォレットは提供されず、すべての MCP クライアントが x402 決済クライアントに自動的に変わるわけでもありません。このローカルアダプターを、対応している自動決済フローに使用してください。
支払いモデル
以下はバージョン 0.3.3 についての説明であり、それ以前の 0.2.1 インストールには適用されません。
- 無料エンドポイントはウォレットなしで利用できます。
- 有料エンドポイントには、USDC を保有する Base ウォレットの秘密鍵である
X402_WALLET_KEYが必要です。公式の x402 v2 パッケージは、選択したリクエストに対して EIP-3009 承認に署名します。クライアントが許可するのは、Base メインネット、公式 USDC、設定されたマーチャントのみです。リソースの完全な URL を確認し、リダイレクトを拒否します。 キーがない場合、有料 MCP ツールは購入を送信する代わりに、明確な案内を返します。 X402_MAX_USD(既定値は1.00)は、小数点以下最大6桁の正確な USDC 小数値です。空の値、負の値、指数表記、16進数表記は拒否されます。0にすると支払いは無効になります。これは呼び出しごとの承認上限であり、日次予算ではありません。- リクエストの実行時間と JSON リクエスト/レスポンスのサイズには上限があります。署名済みリクエストは最大1回しか送信されません。送信後のタイムアウトは結果不明であり、マーチャントが支払いを拒否した証拠ではありません。
- 受け付けられたバックグラウンドジョブ(
202)は、購入情報と認証済みステータス URL を含む受け付け済みとして記録されます。結果が配信されたとは報告されません。 - 支払いの試行は送信前に永続化されます。同じ正規化済みリクエストを繰り返しても、既定では追加の支払いは発生しません。すでに配信済みのリクエストを意図的に新規購入するには、MCP 引数
confirmNewPurchase: trueまたは CLI フラグ--new-purchaseが必要です。どちらの方法も、受け付け済みまたは不明確な購入を上書きすることはありません。 - 秘密状態ディレクトリとその親ディレクトリは、必ず一緒に保持してください。親ディレクトリには、ストアの欠落を検出するブートストラップマーカーがあります。状態が破損または不完全な場合、支払いはブロックされ、暗黙にリセットされることはありません。親ディレクトリとマーカーが完全に失われた場合、新しいプロセスでは初回利用と区別できません。購入を再試行するために削除しないでください。複数のクライアントやコンテナーでこのガードを共有するには、同じ永続状態を共有する必要があります。
MCP のレスポンスには、_meta["io.connskill/payment"] に支払い状態が含まれます。結果が不確かな場合は、テキストの結果にも購入参照情報と doNotPayAgain が含まれます。承認署名や秘密鍵は試行ストアに保存されません。このクライアントはサポート用に購入参照情報を使用しますが、支払いヘッダーを自動的に再送したり、レスポンスを復元するための代替署名を作成したりすることはありません。
⚠️ このキーを使うと、実際の USDC が消費される可能性があります。エージェントが使ってよい金額だけを入金した専用ウォレットを使用してください。メインウォレットは絶対に使用しないでください。
インストール
0.3.3 のソースには Node.js 22 以降が必要です。ロックファイルには、Node 22 を必要とするランタイム依存関係が含まれています。
以下の npx の例では、公開されている npm リリースを選択します。最初にそのバージョンを確認してください。
チェックアウトしたソースを実行するには、ソースのセットアップ後に node と index.mjs の絶対パスを使用してください。
無料の検索にはウォレットは不要です。
Claude Code
claude mcp add connskill-growth -s user -e X402_WALLET_KEY=0x... -e X402_MAX_USD=0.50 -- npx -y @connskill/mcp-growth-services
または、スキル付きの GitHub プラグインをインストールします(npm とは別のソース経路です。ウォレットの認証情報はクライアントを通じて設定してください)。
claude plugin marketplace add CONN-SKILL/connskill-growth-mcp
claude plugin install connskill-growth@connskill
Codex
codex mcp add connskill-growth --env X402_WALLET_KEY=0x... --env X402_MAX_USD=0.50 -- npx -y @connskill/mcp-growth-services
スキルのみの場合:skills/connskill-growth フォルダー全体を ~/.agents/skills/ にコピーしてください。スクリプトはローカルモジュールを共有しているため、x402-call.mjs だけをコピーしても動作しません。
Cursor / Claude Desktop(mcpServers)
{
"mcpServers": {
"connskill-growth": {
"command": "npx",
"args": ["-y", "@connskill/mcp-growth-services"],
"env": { "X402_WALLET_KEY": "0x...", "X402_MAX_USD": "0.50" }
}
}
}
OpenClaw
openclaw mcp add connskill-growth --command npx --arg -y --arg @connskill/mcp-growth-services
スキル:skills/connskill-growth を ~/.agents/skills/(またはワークスペースの skills/)にコピーし、openclaw.json の skills.entries.connskill-growth.env に X402_WALLET_KEY を設定してください。
Hermes(NousResearch hermes-agent)
hermes skills tap add CONN-SKILL/connskill-growth-mcp
hermes skills install connskill-growth
または、~/.hermes/config.yaml の mcp_servers: の下に MCP を設定し、command: npx、args: [-y, @connskill/mcp-growth-services]、env: {X402_WALLET_KEY: ...} を指定します。
ソースから
git clone https://github.com/CONN-SKILL/connskill-growth-mcp
cd connskill-growth-mcp
npm ci
node index.mjs # MCP over stdio
node test-smoke.mjs # lists tools, calls a free endpoint, checks the paid guard (never spends)
ソースからコンテナーを作成
チェックアウトしたロックファイルと、バージョンを固定した公式 Node イメージを使用して、このディレクトリからビルドします。
docker build --tag connskill-growth-mcp:local .
docker run --rm -i connskill-growth-mcp:local
コンテナーは権限のない node ユーザーとして実行され、STDIO 経由で通信します。
標準入力を開いたままにしてください(-i)。ポートは公開されません。無料のエンドポイントはウォレットなしで利用できます。
有料で利用する場合は、親ディレクトリを名前付きボリュームに保持し、ランタイム環境を通じてウォレットを渡してください。
docker run --rm -i \
--mount type=volume,src=connskill-growth-state,dst=/home/node/.local/state \
--env X402_WALLET_KEY --env X402_MAX_USD=0.50 \
connskill-growth-mcp:local
同じボリュームを再利用すると、コンテナーを置き換えても試行履歴が保持されます。一時的なコンテナーファイルシステムでは、この保証を得られません。設定はランタイム時にのみ渡してください。ビルドコンテキストに含まれるのは、明示的に許可されたパッケージファイルのみです。認証情報とローカル依存関係は含まれません。
ローカルのコンテナー候補は、公開済みの Glama リリースとは別のものです。Glama への公開には、ビルドテストの成功と、既存のメンテナー用インターフェースを通じた公開が必要です。
コピーしたスタンドアロンのスキルで、署名なしの呼び出しに必要なのは Node のみです。有料の呼び出しでは、このソースツリーからロック済みのパッケージ依存関係をインストールするか、Node が依存関係を解決できる親パッケージディレクトリに @x402/[email protected]、@x402/[email protected]、@x402/[email protected] および viem をインストールしてください。SDK のインポートは遅延実行されるため、無料の検索にウォレットや支払いストアは必要ありません。
環境変数
| Var | デフォルト | 意味 |
|---|---|---|
X402_ORIGIN | https://agent.connskill.com | 認証情報、パス、クエリー、フラグメントを含まない HTTPS オリジン |
X402_WALLET_KEY | – | USDC を保有する Base 秘密鍵(有料呼び出しを有効化) |
X402_MAX_USD | 1.00 | 有料呼び出しごとの正確な USDC 上限。小数点以下は最大 6 桁 |
X402_PAY_TO | デフォルトのオリジンに対する CONNSKILL の加盟店 | 期待される Base 送金先。カスタムオリジンでは明示的に設定する必要があります |
X402_STATE_DIR | ~/.local/state/connskill-mcp | 非公開の試行履歴ストアの絶対パス。親ディレクトリとマーカーを保持してください |
販売内容(抜粋)
現在の金額と料金プランは、x402 discovery documentに記載されています。 実際の支払いチャレンジでは、選択したリクエストの金額が確定します。
GET /v1/local-market-check-quote(無料)、その後、承認済みのPOST /v1/local-market-checkを1回POST /v1/ranked-keywordsPOST /v1/keyword-ideasPOST /v1/keyword-metrics(リンク先の利用手順では、タスクは選択したキーワード1~10個に制限されています。APIの制限については、最新のスキーマを確認してください)POST /v1/keyword-metrics-multi(最大30か所、支払いは1回)POST /v1/serp-report(オーガニック検索+AIによる概要、PAA、強調スニペット)POST /v1/site-audit(Labs+被リンク+実際のオンページクロール)POST /v1/trust-check(x402の販売者を審査:リアルタイムの402、流入、自己取引)POST /sms/v1/sms-order(最初に見積もりを取得、無料)POST /mail/v1/mail-inbox(7日間の受信専用インボックス)POST /ai/v1/eu-chat(ドイツでホスト、ツールを使用)
何か足りないものはありますか?POST /v1/wishlistは無料で、人が確認します。
ライセンス
MIT。ドイツ、トラウンシュタインのCONNSKILL GmbH & Co. KGが開発しました。
任意のディスカバリーチャネル測定
このMCPアダプターによる呼び出しでは、User-Agentヘッダーでソフトウェアをconnskill-growth-mcp
として識別します。任意でX402_DISCOVERY_SOURCEに、実際に見つけた場所(github、npm、glama、mcp-registry、x402scan、402index、x402-list、agenstry、website)を設定してください。不明な場合は設定しないでください。この機能によって訪問者ID、IPアドレス、ウォレットキーが追加されることはありません。既存の支払いプロトコルでは、引き続き購入の決済に支払者のウォレットが使用されます。
販売者はこれをMCPクライアントの利用とは別に、自己申告のチャネルとして報告します。HTTPリクエストが成功しただけでは販売としてカウントされません。報告には、対応する支払いと、保存された配信成功の記録が必要です。チャネルを示す証拠が欠落している、または矛盾している場合は、不明のまま扱われます。npm経由でインストールしたことは、購入者がnpm経由で購入した証明にはなりません。この測定によって、エンドポイントURL、署名付きリソース、購入リクエスト本文が変更されることはありません。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。