originselect-mcp-server

OriginSelect MCP サーバー

OriginSelect の Model Context Protocol サーバーです。AI エージェントを通じて、倫理的で原産地が検証済みの商品やブランドを検索できます。

Claude Desktop、Cursor、Windsurf、および MCP 互換クライアントで利用できます。

API ドキュメントやその他の連携方法については、OriginSelect の開発者向けページをご覧ください。

クイックスタート

オプション 1：npx（推奨）

インストールは不要です。Claude Desktop の設定に追加するだけです。

{
  "mcpServers": {
    "originselect": {
      "command": "npx",
      "args": ["originselect-mcp-server"]
    }
  }
}

オプション 2：グローバルインストール

npm install -g originselect-mcp-server

次に、Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "originselect": {
      "command": "originselect-mcp-server"
    }
  }
}

オプション 3：ソースから

git clone https://github.com/chhavimishra/originselect-mcp-server.git
cd originselect-mcp-server
npm install

{
  "mcpServers": {
    "originselect": {
      "command": "node",
      "args": ["/absolute/path/to/originselect-mcp-server/src/index.js"],
      "env": {
        "API_BASE_URL": "https://api.originselect.com"
      }
    }
  }
}

Cursor / Windsurf

MCP の設定に追加します。

{
  "originselect": {
    "command": "npx",
    "args": ["originselect-mcp-server"]
  }
}

クエリの例

接続したら、AI アシスタントに質問できます。

• 「カナダ産で 25 ドル以下のオーガニックベビー用品を探して」
• 「アメリカの女性が経営するコーヒーブランドを見せて」
• 「B Corp 認証を取得したスキンケアブランドはありますか？」
• 「ヴィーガンで動物実験を行っていないペット用品を探して」

ツール

search_products

価値観、国、カテゴリー、ブランド、キーワードを指定して、厳選された商品カタログを検索します。

"Find organic baby products from Canada under $25"
→ { country: "Canada", category: "Baby", values: ["organic"], priceMax: 25 }

パラメーター	型	説明
query	string	コンテキスト用の任意の自然言語クエリ
country	string	原産国（Canada、USA）
category	string	商品カテゴリー（Beauty、Baby、Pet Care など）
values	string[]	倫理的価値観（women-owned、organic、b-corp など）
brand	string	ブランド名
keywords	string[]	商品のキーワード（shampoo、coffee など）
priceMax	number	価格の上限（ドル）
market	string	canada、global、または all（デフォルト：all）
limit	number	商品の最大数（1〜50、デフォルト：12）

search_brands

倫理的価値観、国、またはカテゴリーからブランドを探します。

パラメーター	型	説明
country	string	原産国
values	string[]	倫理的価値観
category	string	商品カテゴリー
brand	string	検索するブランド名
market	string	市場の範囲
limit	number	ブランドの最大数（1〜20、デフォルト：10）

refine_search

フィルターを追加または削除して、前回の検索を絞り込みます。以前の search_products の応答から intent オブジェクトを受け取り、変更を適用します。最初から再検索する必要はありません。

{
  "intent": { "...from previous response..." },
  "modifications": [
    { "action": "add", "field": "values", "value": "organic" },
    { "action": "remove", "field": "values", "value": "vegan" },
    { "action": "modify", "field": "priceMax", "value": 30 }
  ]
}

get_values

対応している 21 種類の倫理的価値観／所有形態（women-owned、b-corp、organic など）をすべて一覧表示します。

get_categories

対応している 17 種類の商品カテゴリーをすべて一覧表示します。

get_countries

対応しているすべての原産国を一覧表示します（現在はカナダとアメリカ）。

ファーストパーティのインテリジェンスツール

OriginSelect 独自のトラフィック／収益データ。利用には INTELLIGENCE_API_KEY が必要です （環境変数を参照）。すべてのレスポンスは範囲が限定されており、日付の対象期間と データの鮮度に関する情報が含まれます。また、帰属の種別を deterministic／aggregate／inferred と明示するため、各数値をどの程度信頼できるかを把握できます。これらのツールが答えるのは 「自社サイトで何が起きているか」であり、公開ウェブの調査（SERP、競合他社）ではありません。 そちらは別途、ご自身の検索／ブラウズツールで行ってください。

ツール	目的
get_daily_priorities	根拠と理由コードを含む、優先度順の上位の施策候補
get_page_performance	1 つの URL のチャネル横断パフォーマンス
get_query_performance	1 つのクエリの、検索エンジンおよびページ別のパフォーマンス
get_page_queries	1 つのページへのトラフィックを生み出しているクエリ
get_query_pages	1 つのクエリでランキングされているページ
get_ranking_changes	時間の経過に伴う、ページのクエリの獲得／損失
get_ctr_opportunities	掲載順位に対して CTR が低いページ／クエリ
get_cannibalization	ページの表示が重複しているクエリ
get_channel_performance	1 つのページの Google／Bing／Pinterest／AI 別内訳
get_affiliate_performance	プログラムおよび市場別のアフィリエイトクリック数／収益／コミッション
get_ai_referral_performance	1 つのページに対する AI 検索エンジンからのリファラル動向
get_change_history	1 つのページに記録されたビルド／コンテンツの変更
get_data_freshness	すべてのインテリジェンスソースのコネクタ状態

アーキテクチャ

AI Agent (Claude, GPT, Cursor)
    │
    │  MCP (stdio)
    ▼
┌─────────────────────────┐
│  MCP Server (this pkg)  │
│  19 tools               │
└───────────┬─────────────┘
            │  HTTPS
            ▼
┌─────────────────────────┐
│  OriginSelect API       │
│  api.originselect.com   │
└─────────────────────────┘

環境変数

変数	デフォルト	説明
API_BASE_URL	https://api.originselect.com	Discovery API のベース URL
INTELLIGENCE_API_KEY	(なし)	上記のインテリジェンスツールでのみ必要です。製品検索には不要です

サポートされる値

women-owned · black-owned · indigenous-owned · veteran-owned
family-owned · lgbtq-owned · aapi-owned · latino-owned · minority-owned
b-corp · organic · sustainable · vegan · non-gmo · fair-trade
non-toxic · cruelty-free · fragrance-free · plastic-free
social-impact · gluten-free

セキュリティと信頼性

この MCP サーバーはオープンソースで、完全に監査できます。

• 読み取り専用 — api.originselect.com への外向き HTTPS リクエストのみを行います
• ファイルシステムへのアクセスなし — ローカルファイルの読み取りも書き込みも行いません
• テレメトリなし — ユーザーデータや分析情報をどこにも送信しません
• 最小限の依存関係 — ランタイム依存関係は 1 つ（@modelcontextprotocol/sdk）のみです
• ソースコード — github.com/chhavimishra/originselect-mcp-server

脆弱性の報告については、SECURITY.md をご覧ください。

ライセンス

MIT

プライベート ChatGPT トランスポート（準備済み、未公開・未デプロイ）

既存の src/index.js の stdio エントリーポイントと、19 個のツール一覧は変更されません。プライベートな Codex 接続では、現在のランチャーとサーバー側の INTELLIGENCE_API_KEY 設定を引き続き使用できます。

originselect-mcp-server/intelligence は、既存の 13 個のインテリジェンス記述子を再利用する独立したファクトリー createIntelligenceServer をエクスポートします。認証済みの読み取りディスパッチャーが必要です。カタログ／変更のディスパッチは含まれず、厳格なスキーマ、OAuth メタデータ、読み取り専用アノテーションが追加されます。リモート専用オプションでは、固定されたページのみのベースラインと、日付指定の国／デバイス診断を利用できます。これらのオプションによって、従来の stdio スキーマが変更されることはありません。

既存の OriginSelect バックエンドは、ステートレスな Streamable HTTP を使用して、このファクトリーを提案された https://mcp.originselect.com/mcp エンドポイントにマウントします。Cognito は公式 MCP SDK の OAuth プロキシを通じて、ユーザーのサインイン／PKCE／トークン更新を処理します。バックエンドコントローラーは読み取りを直接実行します。ChatGPT にインテリジェンス API キーが渡されたり、URL に含められたり、OAuth トークンで転送されたりすることはありません。

バックエンドは、scripts/vendor-private-mcp.mjs が生成するローカルの vendor/originselect-mcp-server-1.0.12.tgz をインストールします。npm への公開は不要です。このファクトリーまたはその記述子を変更した後は、その成果物を再ビルドし、バックエンドのロックファイルを更新してください。ベンダー化されたマニフェストには、アーカイブのチェックサムが記録されます。

デプロイ、所有者の許可リストへの登録、ChatGPT の接続手順、ロールバックについては、バックエンドの intelligence/mcp/README.md に記載されています。ローカル SDK テストは ChatGPT による受け入れを意味しません。保存済みの 2026 年 8 月 8 日〜9 月 4 日のページのみの証拠と一致する、認証済みの ChatGPT 呼び出しが実際に確認されるまでは、デプロイは受け入れ済みとはなりません。