shruwd-mcp

shruwd-mcp

Shruwd 用のローカル MCP サーバーです。 AI エージェント（Claude Desktop、Claude Code、Cursor など、MCP に対応するもの）を使って、ブランドを設定し、追跡するプロンプトと競合他社を追加し、AI が生成した回答でブランドがどのように表示されるかを確認し、診断結果に基づいて対応できます。

Shruwd ダッシュボード（Account → API keys）で API キーを取得する必要があります。キーは 1 つのワークスペースに紐づき、その中のブランドにアクセスできます。ワークスペースの所有者であればすべてのブランド、そうでなければメンバーになっているブランドにアクセスできます。各ブランドでは、自分のロールに応じた操作ができます。読み取りには viewer、書き込みには editor、インジェストトークンの発行には admin が必要です。ブランドの作成またはアーカイブには所有者権限が必要です。複数のワークスペースで使用するには、それぞれでキーを発行し、ワークスペースごとにサーバーエントリを追加してください。

ホスト型、インストール不要

同じツールを https://shruwd.io/mcp（Streamable HTTP）で利用できます。Claude.ai、ChatGPT、Grok では、この URL をカスタムコネクターとして追加し、Shruwd アカウントでサインインしてください。キーは不要です。ヘッダーを指定できるクライアントでは、代わりにキーを送信できます。

claude mcp add --transport http shruwd https://shruwd.io/mcp --header "Authorization: Bearer sh_live_…"

各アプリのセットアップ方法：shruwd.io/docs/api/mcp-server。

Claude Desktop

claude_desktop_config.json：

{
  "mcpServers": {
    "shruwd": {
      "command": "npx",
      "args": ["-y", "shruwd-mcp"],
      "env": { "SHRUWD_API_KEY": "sh_live_…" }
    }
  }
}

Claude Code

claude mcp add shruwd -e SHRUWD_API_KEY=sh_live_… -- npx -y shruwd-mcp

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "shruwd": {
      "command": "npx",
      "args": ["-y", "shruwd-mcp"],
      "env": { "SHRUWD_API_KEY": "sh_live_…" }
    }
  }
}

ツール

ツール	内容
shruwd_get_workspace	プラン、利用権限、使用状況、ブランド。まずここから始めてください。
shruwd_list_brands · shruwd_get_brand · shruwd_create_brand · shruwd_update_brand · shruwd_archive_brand	ブランド。ブランドを作成すると、そのブランド自身のエンティティと最初の測定も作成されます。作成とアーカイブには owner が必要です。
shruwd_list_prompts · shruwd_add_prompts · shruwd_update_prompt · shruwd_remove_prompt	各サイクルで各エンジンに尋ねる質問と、それぞれに回答するサイト上のページです。
shruwd_list_entities · shruwd_add_competitor · shruwd_set_entity · shruwd_remove_entity	ブランドと競合他社、および言及として数える正確な別名です。
shruwd_run_measurement · shruwd_list_cycles	今すぐ測定し、サイクルを確認します。結果はその後数時間かけて届きます。
shruwd_get_visibility · shruwd_get_visibility_series · shruwd_get_crawlers	区間付きの言及率とシェア・オブ・ボイスを現在および各サイクル終了時に確認できます。また、検証済みの AI クローラーのアクティビティも確認できます。
shruwd_list_crawler_paths	各クローラーが取得したパスと取得結果を確認できます。ボットのエラー発生元を特定できます。
shruwd_list_answers	最新の個別回答を確認できます。ブランドが言及されたか、その順位、言及された競合他社、引用されたページがわかります。1 つのプロンプト（調査結果の subjectRef）または 1 つのエンジンに絞り込めます。指標ではなく、証拠を示します。
shruwd_list_suggestions · shruwd_accept_suggestion · shruwd_dismiss_suggestion	回答で言及されたものの、ブランドがまだ追跡していない競合他社です。
shruwd_suggest_setup	回答対象となるページをそれぞれ指定した 10～25 件のプロンプトと、ホームページおよびサイトマップから最大 6 社の競合他社を提案します。通常のツールで追加するまで、何も保存されません。
shruwd_list_findings · shruwd_get_finding · shruwd_transition_finding	具体的な修正案を含む診断です。修正を適用済みとしてマークすると、再確認が始まります。表示できる調査結果に上限のあるプランでは、残りの件数が locked として返されます。
shruwd_create_ingest_token	サーバーログ送信用のトークンとエンドポイントです。admin が必要です。

各ツールは API が返す内容をそのまま返します。指標は単なる数値ではなく、95% 区間と n を含む点推定値、または明示的な insufficient_data 状態です。ツールの説明では、エージェントがこれをゼロと解釈しないよう指示しています。表示可能な調査結果に上限のあるプランでは、残りの件数を隠さず、locked として報告します。

環境変数

変数
SHRUWD_API_KEY	必須です。
SHRUWD_API_URL	省略可能です。デフォルトは https://shruwd.io/api/v1 です。