ShellWire

ShellWire MCP とエージェントの連携

ShellWire 向けの公式 Model Context Protocol（MCP）クライアント設定、インストール可能なエージェントスキル、公開 HTTP API ドキュメントです。

ShellWire では、役立つソフトウェアをトップページに掲載し、説明可能なランキングと、ユーザーや AI アシスタント向けの探索機能を提供しています。AI アシスタント、チャットボット、開発者ツール、日常使いのソフトウェアを、それらが解決する課題から探せます。日付付きの情報源に裏付けられた記載済みの機能を比較し、各アプリケーションの有用性スコアの算出方法も確認できます。

リポジトリの範囲： ShellWire はホスト型サービス（https://shellwire.com/）であり、アプリケーションのコードベースは非公開です。この公開リポジトリには、公式 MCP Registry マニフェスト（server.json）、クライアント設定ガイド、エージェントスキル（skills/shellwire/SKILL.md）、および AI アシスタントや HTTP クライアントを ShellWire に接続するための OpenAPI 仕様（openapi.json）が含まれています。

主なリンク

• ウェブサイト： https://shellwire.com/
• アシスタント接続ページ： https://shellwire.com/connect
• ホスト型 MCP エンドポイント（Streamable HTTP）： https://shellwire.com/mcp
• 公式 MCP Registry ID： io.github.Kiragu-Maina/shellwire（Registry Record）
• リーダーボード： https://shellwire.com/leaderboard
• アプリケーションの送信： https://shellwire.com/submit

---

クイック接続（MCP）

ShellWire は、https://shellwire.com/mcp でリモートの Streamable HTTP MCP サーバーを公開しています。公開情報の検索、ツールの比較、ニュースの閲覧は 匿名 で利用でき、API キーもサインインも不要です。

Claude Code

claude mcp add --transport http shellwire https://shellwire.com/mcp

Cursor / VS Code / Windsurf（mcp.json）

{
  "mcpServers": {
    "shellwire": {
      "type": "http",
      "url": "https://shellwire.com/mcp"
    }
  }
}

OpenCode（opencode.json）

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "shellwire": {
      "type": "remote",
      "url": "https://shellwire.com/mcp",
      "enabled": true
    }
  }
}

認証済みビルダー設定（任意）

エージェントがアプリケーションを送信する場合や、非公開の送信ステータスを確認する場合は、ファーストパーティーのメール OTP HTTP フローで取得した有効期間 8 時間のビルダー Bearer トークンを指定してください（以下のビルダー認証を参照）。

{
  "mcpServers": {
    "shellwire": {
      "type": "http",
      "url": "https://shellwire.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SHELLWIRE_BUILDER_TOKEN}"
      }
    }
  }
}

---

MCP ツールのリファレンス（8 個のツール）

公開情報の検索ツール（匿名）

ツール	タイトル	入力引数	説明
search	ShellWire を検索	{ "query": "string (max 200 chars)" }	公開アプリケーション、チャットボットカタログ、ラベル付きニュースを検索します。最大 24 件の安定した ID（tool:<uuid> または news:<uuid>）、タイトル、正規の引用 URL を返します。
fetch	公開レコードを読む	{ "id": "tool:<uuid> | news:<uuid>" }	search が返した公開レコード ID を 1 件取得します。引用可能なテキスト、構造化メタデータ、日付付きの根拠資料を含みます。
compare_tools	チャットボットとツールを比較	{ "ids": ["tool:<uuid>", "..."] }（1～4 件の ID）	異なる公開ツール ID を 1～4 件、並べて比較します。生成された評価を加えず、不明な事実、情報源の根拠、確認日を保持します。
get_chatbot_brief	チャットボットの概要を読む	{ "limit": 4 }（任意、1～4）	ShellWire のホームページに掲載されている、情報源を確認済みの概要を読み込みます。ラベル付きの記事（reporting、discussion、analysis）を最大 4 件と、関連する公開ツールが含まれます。
get_submission_instructions	ビルダーの送信手順を読む	{}	認証が必要な非公開の送信について、匿名で認証情報を必要としない手順を返します。正確な HTTP OTP エンドポイント、制限付きの送信フィールド、バイナリー画像のアップロード規則が含まれます。

ビルダー向け送信ツール（メール OTP ベアラートークンが必要です）

ツール	入力引数	説明
verify_homepage_backlink	{ "officialUrl": "https://example.com" }	公開 HTTPS ウェブサイトのルートホームページに、https://shellwire.com/ への表示されるネイティブ HTML アンカーがあることを確認します。キャッシュ期間は 5 分です。
submit_application	{ "name", "officialUrl", "description", "email"?, "details"?, "images"? }	ホームページのバックリンクを確認した後、アプリケーションまたは個人用 AI エージェントを送信し、運営者による非公開レビューを依頼します。同じ正規化済み URL に対する保留中の送信が繰り返された場合、レコードを重複して作成せずに受け付けたことを通知します。
list_my_submissions	{}	認証済みビルダーアカウントの非公開の送信ステータス（pending、accepted、rejected）、任意の公開済みツール URL、およびアップロード済み画像のプレビューのみを返します。

---

ビルダー認証（メール OTP）

ShellWire は、ビルダーの書き込み操作にファーストパーティのメール OTP ベアラートークンを使用します。標準 OAuth は使用されないため、URL のみを扱う OAuth クライアントは、HTTPS 経由でベアラートークンを事前に取得しない限り、認証が必要な書き込みツールを使用できません。

1. 6 桁の OTP コードをリクエストします：

   curl -X POST https://shellwire.com/api/directory/account/agent/send-code \
     -H "Content-Type: application/json" \
     -d '{"email": "[email protected]"}'
   

2. コードを 8 時間有効なベアラートークンと交換します： 認証済みのメールボックスから 6 桁のコードを取得する（または人間のユーザーに尋ねる）と、HTTPS 経由で交換します：

   curl -X POST https://shellwire.com/api/directory/account/agent/token \
     -H "Content-Type: application/json" \
     -d '{"email": "[email protected]", "code": "123456"}'
   

   レスポンス：

   {
     "access_token": "<token>",
     "token_type": "Bearer",
     "expires_in": 28800,
     "user": {
       "id": "<uuid>",
       "email": "[email protected]"
     }
   }
   

3. 任意のバイナリスクリーンショットをアップロードします（最大 4 枚、各最大 5 MiB）： 生のバイナリバイト（image/png、image/jpeg、または image/webp。multipart や base64 は不可）を送信します：

   curl -X POST https://shellwire.com/api/directory/media \
     -H "Authorization: Bearer ${SHELLWIRE_BUILDER_TOKEN}" \
     -H "Content-Type: image/png" \
     --data-binary @screenshot.png
   

4. バックリンクを確認し、MCP 経由で送信します： ルートホームページに https://shellwire.com/ への表示されるリンクがあることを確認し、verify_homepage_backlink を呼び出してから、submit_application を呼び出します。
5. 完了したらトークンを無効化します：

   curl -X POST https://shellwire.com/api/directory/account/agent/revoke \
     -H "Authorization: Bearer ${SHELLWIRE_BUILDER_TOKEN}"
   

---

公開 REST カタログ API

MCP に加えて、ShellWire は https://shellwire.com/api/directory 配下に公開 JSON エンドポイントを提供しています（完全な仕様は openapi.json を参照してください）：

• GET /api/directory/status - サービスおよび MCP の利用可能状況
• GET /api/directory/tools - 公開済みツールの検索と絞り込み（q、category、kind、free、capability、limit、offset）
• GET /api/directory/tools/:slug - 日付付きのエビデンスと機能を含む、公開済みツールのレコードをスラッグで取得
• GET /api/directory/categories - ディレクトリのカテゴリとツール数の一覧
• GET /api/directory/leaderboard - 説明可能なヒューリスティック・リーダーボードを取得（q、category、limit）。要素ごとのポイント内訳も含みます
• GET /api/directory/brief - ホームページのチャットボット向けニュース概要を取得
• GET /api/directory/compare?ids=<uuid1>,<uuid2> - 公開済みツールを最大 4 件、並べて比較
• GET /api/directory/search?q=<query> - ツールとラベル付きニュースを横断して統合検索
• GET /api/directory/records/:id - 引用可能なテキストを含む公開レコード（tool:<uuid> または news:<uuid>）を取得

エージェントスキルとしてインストールする

このリポジトリには、標準のエージェントスキルが skills/shellwire/SKILL.md に含まれています：

npx skills add Kiragu-Maina/shellwire-mcp

ライセンス

このリポジトリのドキュメント、スキーマ、設定例、およびエージェントスキルファイルは、MIT License のもとで公開されています。