Skip to main content
Glama
amazon-hikaku MCP Server

amazon-hikaku MCP Server

by aegisfleet
README.md
# amazon-hikaku MCP サーバー

[ポちのAmazon商品徹底比較.com](https://www.amazon-hikaku.com/)(amazon-hikaku.com)の調査データを、ChatGPT や Claude などの AI アシスタントから直接検索・参照できるようにする MCP サーバーです。

サイトが独自に調査した全商品について、独自スコア(0〜100点)、価格、スペック、長所・短所、スコアの採点根拠などを、AI がそのまま使える形で返します。買い物の相談をするときにこのサーバーを接続しておくと、AI が実際の調査データに基づいて候補を挙げ、比較し、出典として商品詳細ページへのリンクを添えて回答できます。

- **エンドポイント**: `https://mcp.amazon-hikaku.com/mcp`
- **認証**: 不要(公開・読み取り専用)
- **方式**: MCP / Streamable HTTP

## 接続方法

### ChatGPT(Web版)

1. 左メニューの「プラグイン」を開く
2. 「追加」(+ボタン)→「カスタム MCP サーバーを追加」
3. 名前(例: `Amazon商品検索`)を入力し、「接続」のサーバー URL に `https://mcp.amazon-hikaku.com/mcp` を入力。認証は「認証なし」を選ぶ
4. リスクに関する警告を確認し、「内容を理解したうえで続行」を選択
5. 「プラグインとして作成」→ 検出されたツールを確認してインストール
6. チャットで入力欄に `@` と入力し、このプラグインを選んで質問する

入力画面の例(名前は任意です):

![ChatGPT のカスタム MCP サーバー追加画面](docs/images/chatgpt-add-mcp-server.png)

### Gemini

1. 左メニューの「カスタマイズ」を開き、「連携サービス」タブで「カスタム」を選ぶ
2. 「MCP サーバーに接続」ダイアログで、サーバーの URL に `https://mcp.amazon-hikaku.com/mcp` を入力し、「次へ」
3. カスタム接続済みアプリについての注意を確認して接続を完了する(認証は不要です)

入力画面の例:

![Gemini の MCP サーバー接続画面](docs/images/gemini-add-mcp-server.png)

### Claude

1. 左メニューの「プラグイン」を開く
2. 「追加」→「カスタムコネクタを追加」
3. 名前(例: `Amazon商品検索`)と MCP サーバー URL `https://mcp.amazon-hikaku.com/mcp` を入力
4. 認証は「サインインなし」を選んで追加
5. チャットで「+」→「コネクタ」から有効にして質問する

入力画面の例(名前は任意です):

![Claude のカスタムコネクタ追加画面(名前と URL の入力)](docs/images/claude-add-connector-1.png)

![Claude のカスタムコネクタ追加画面(認証は「サインインなし」)](docs/images/claude-add-connector-2.png)

### Grok

1. 設定 →「Connect Apps」を開き、下の方にある「Add a custom connector」を選ぶ
2. 名前(例: `Amazon商品検索`)とサーバー URL `https://mcp.amazon-hikaku.com/mcp` を入力(ヘッダーは空で構いません)
3. 「MCPを追加」

入力画面の例(名前は任意です):

![Grok の MCP サーバー追加画面](docs/images/grok-add-mcp-server.png)

### MCP 対応クライアント全般(Claude Code / Cursor など)

MCP サーバーの設定に以下を追加してください。

```json
{
  "mcpServers": {
    "amazon-hikaku": {
      "url": "https://mcp.amazon-hikaku.com/mcp"
    }
  }
}
```

## 使い方の例

接続した AI に、たとえばこう聞けます。

- 「3万円以下で評価の高いワイヤレスイヤホンを探して」
- 「ソニーのノイキャンイヤホンでおすすめは?」(ブランドのカタカナ表記や略語でも探せます)
- 「Anker のモバイルバッテリーで一番おすすめはどれ?」
- 「この2つの商品(ASIN: B0… と B0…)を比較して」
- 「今セールで30%以上安くなっている商品を教えて」
- 「ブラックフライデーのセールでおすすめはある?」(セールの種類は商品ごとのバッジで区別されます。開催前など該当がない時期は、その旨と現在開催中のセールが返ります)
- 「送料無料まであと少し。2,000円以下で良いものある?」
- 「スコア90点以上の商品だけ見せて」

AI は出典として amazon-hikaku.com の商品詳細ページへのリンクを添えて回答します。詳しいスペック表や価格推移(Keepa)はそちらで確認できます。

条件が曖昧な相談では、AI が予算・用途などの絞り込みを聞き返すことがあります。そのまま答えると、条件に合わせて候補を調べ直してくれます。

## 使えるツール

| ツール | 内容 |
|---|---|
| `search_products` | キーワード/カテゴリ/ブランド/価格/スコアで商品を検索。ブランドの日英表記ゆれ(ソニー/Sony 等)や略語・同義語(ノイキャン、USB-C/Type-C 等)も自動で吸収 |
| `get_product` | 1商品の詳細(スペック、在庫、調査日、スコアの採点根拠) |
| `compare_products` | 2〜5商品の横並び比較(最安・最高スコア・価格差などの要約と、長所・短所リストつき) |
| `find_similar_products` | 指定商品と同カテゴリの代替候補(在庫切れ・予算超過のときに) |
| `list_categories` | カテゴリ一覧(親→子の階層と件数) |
| `list_brands` | ブランド検索(表記揺れにも対応) |
| `get_deals` | セール中の商品(既定はスコアと割引率のバランス順。低スコア品を避けるため既定でスコア70点以上。セール種別での絞り込みも可) |
| `get_bargain` | 目標金額以下の「あともう一品」候補(下限金額の指定も可) |
| `get_recommendations` | スコア90点以上の高評価商品 |

## 相談プロンプト(MCP Prompts)

ツールのほかに、相談の進め方を AI に渡すテンプレート(プロンプト)を2件用意しています。MCP Prompts に対応したクライアントでは、コマンドやテンプレートとして選べます(対応状況はクライアントによります)。

| プロンプト | 内容 |
|---|---|
| `shopping_consultation` | 買い物相談用。まず候補を調べ、予算・用途などが曖昧なら実際の選択肢で最大3点まで聞き返し、回答に合わせて再検索して比較と推奨まで進める。引数 `topic` にテーマ(例: ワイヤレスイヤホン)を渡せる |
| `bargain_hunting` | セール・買い合わせ相談用。セール商品と「あと一品」候補を、割引率だけでなくスコアも見て絞り込む。引数 `occasion` に用途を渡せる |

## データについて

- データは amazon-hikaku.com の調査結果そのもので、サーバー側で1時間ごとに最新の公開データへ更新されます
- 価格は各商品の「調査時点」の価格です。最新の価格はリンク先の詳細ページでご確認ください
- スコアはサイト独自の採点(基本点+加点・減点)で、各商品の `score_rationale` に根拠が入っています
- 書き込み機能はありません。検索と参照だけの読み取り専用です

## セキュリティと信頼性設計

AI クライアントから安心して接続いただけるよう、以下の安全設計を採用し、ソースコードを完全公開しています(詳細は [SECURITY.md](SECURITY.md) を参照)。

- **完全読み取り専用(副作用なし)**: 全9ツールに MCP 標準の `ToolAnnotations(readOnlyHint=True, destructiveHint=False, idempotentHint=True)` を付与しており、外部データの書き換えや購入操作などは一切行いません
- **認証不要・個人情報の非保持(ステートレス)**: Streamable HTTP のステートレスモード(`stateless_http=True`)で動作し、API キー、アカウント情報、会話セッション履歴を保持しません
- **公開データのみ参照**: サーバーが取得するのは `https://www.amazon-hikaku.com` 上の公開調査 JSON のみ(1時間キャッシュ)で、任意の外部 URL へアクセスする機能は持ちません
- **過負荷・悪用防止ガード**: リクエストボディ上限(64KB、ヘッダー検査およびストリーム実測)と IP 単位のレート制限(240 req/min)、各種セキュリティヘッダー(`X-Content-Type-Options: nosniff`、`Cache-Control: no-store` 等)を適用しています
- **コンテナと依存関係の保護**: `uv.lock` による決定論的ビルド、非特権ユーザー(non-root)でのコンテナ実行、Dependabot と `pip-audit` による継続的な脆弱性スキャンを実施しています

## 関連リンク

- [amazon-hikaku.com](https://www.amazon-hikaku.com/) — 本体サイト
- [AI活用ガイド(/ai/)](https://www.amazon-hikaku.com/ai/) — 各AIクライアントの接続手順と活用例
- [AI・LLM向け案内(llms.txt)](https://www.amazon-hikaku.com/llms.txt) — データ取得方法のまとめ

## ライセンス

[MIT License](LICENSE)

---

開発者向けの情報(構成、デプロイ方法、設計上の注意)は [AGENTS.md](AGENTS.md) を参照してください。

TDQS

A3.7/5.0

Scored across 9 tools

Disambiguation4/5

Each tool targets a distinct intent: single-product lookup, filtered search, comparison, substitution, taxonomy browsing, deals, budget fitting, and recommendations. The closest overlap is between get_deals, get_bargain, and get_recommendations, which are all 'filtered product list' tools, but their descriptions make the boundary clear (sale badges vs. shipping-threshold budget vs. score≥90). find_similar_products could arguably be emulated with search_products plus a category filter, but its price-band logic justifies it.

Naming Consistency5/5

Every tool follows a clean snake_case verb_noun pattern (get_product, search_products, compare_products, find_similar_products, list_categories, list_brands, get_deals, get_bargain, get_recommendations). No mixed conventions or vague standalone verbs.

Tool Count5/5

Nine tools is well within the ideal 3-15 range and each one covers a distinct research workflow. Nothing feels redundant or padded for a product-research/comparison server.

Completeness4/5

The surface covers discovery (search, categories, brands), evaluation (get_product, compare, similar), and deal-finding (deals, bargain, recommendations), which is strong lifecycle coverage for a read-only research domain. Minor gaps: no batch product fetch, no price-history or review-detail endpoint, and pagination is only exposed on search/deals rather than list_brands/list_categories.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues