sentinel-mcp-server

Name: sentinel-mcp-server
Author: haidrau

ローカル

github.com/haidrauビジネス・マーケティング316 週間前に更新

リポジトリ

sentinel-mcp-server について

sentinel-mcp-serverは、ブラウザー拡張機能で選んだ商品のShopee価格監視データをMCP経由で提供します。東南アジア市場の競合価格を追跡する販売者やチーム向けで、未登録商品の検索には対応しません。

主な機能

01監視中の商品と価格の一覧表示
02価格履歴とサマリーの確認
03値下げアラートの取得
04商品の追加と監視の一時停止・再開
05クローラーの状態と監視概要の確認
06東南アジア6市場への対応

活用シーン

01追跡中の競合商品の価格比較
02セール期間中の価格変動の確認
03直近で値下がり幅が大きい商品の特定
04クローラーの状態と監視範囲の確認

MCP 対応

MCP Keyを使い、監視対象商品の照会・管理ツールをMCPクライアントに公開します。ブラウザー拡張機能と登録済み商品が必要で、データ収集には有料のサードパーティAPIを利用します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "haidrau-sentinel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SENTINEL_TOKEN",
        "-e",
        "SENTINEL_API_KEY",
        "ghcr.io/haidrau/sentinel-mcp-server:0.2.0"
      ],
      "env": {
        "SENTINEL_TOKEN": "<SENTINEL_TOKEN>",
        "SENTINEL_API_KEY": "<SENTINEL_API_KEY>"
      }
    }
  }
}

起動コマンドdocker run -i --rm -e SENTINEL_TOKEN -e SENTINEL_API_KEY ghcr.io/haidrau/sentinel-mcp-server:0.2.0

設定が必要な環境変数

SENTINEL_TOKENシークレットYour Sentinel MCP Key. Get it from the browser extension settings page (NOT from the website login). See: https://priceminder.online/docs/quick-start

SENTINEL_API_KEYシークレットInternal API key for backend communication

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

ocighcr.io/haidrau/sentinel-mcp-server:0.2.0SSE

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Priceminder MCP Server

中文 | English

Priceminder — Model Context Protocol（MCP）を通じてAIエージェントを活用する、Shopeeの競合価格をリアルタイムでモニタリングするサービスです。

🌐 無料で登録：priceminder.online

東南アジアのShopee（SG、MY、TH、VN、ID、PH）で競合商品の価格をモニタリングできます。AIエージェントに自然言語で指示するだけで、価格の追跡、分析、変動時の通知を行えます。

📌 重要：まずデータパイプラインをご確認ください

PriceminderのMCPサービスは単独では動作しません。有料のサードパーティAPIデータサービスから取得した競合価格データに依存します。ご利用前に、この3層のパイプラインをご確認ください。

Install Extension → Follow products you want to watch → Backend fetches data via paid APIs → AI Can Query

⚠️ 前提条件

手順	操作	詳細
必須	① ブラウザー拡張機能をインストールする	Chrome／Edge／360 Browser。拡張機能のインストールガイドをご覧ください
必須	② Shopeeの商品ページを閲覧し、「Monitor Now」をクリックする	MCPでアクセスできるのは、手動でモニタリング対象に追加した商品のみです
必須	③ 拡張機能の設定からMCP Keyを取得する	以下のクイックスタートをご覧ください
任意	④ AIクライアントでMCPを設定する	自然言語で価格を問い合わせられるようになります

🔑 MCP Keyの取得場所 MCP Keyは、ブラウザー拡張機能の設定ページに表示されます。拡張機能がなければ、KeyもMCPサービスも利用できません。ウェブサイト（priceminder.online）での登録は、アカウント管理とProへのアップグレードに使用します。MCPへのアクセス認証情報は拡張機能内にあります。

🤖 AI機能の範囲

PriceminderのMCPツールで問い合わせられるのは、手動でモニタリングリストに追加した商品だけです。Shopee全体から任意の商品を検索することはできません。

AIでできること ✅	AIではできないこと ❌
モニタリング中の商品と価格の一覧を表示する	モニタリングしていない商品をShopeeで検索する
モニタリング中の商品の価格履歴と推移を確認する	任意のASIN／商品IDの価格を取得する
値下がりアラートと通知履歴を確認する	追跡していない競合店舗を分析する
新しい商品をモニタリングに追加する（事前に拡張機能でスキャンする必要があります）	新しい競合を自動的に見つける
クローラーエンジンの稼働状況を確認する	アカウントのパスワードや設定を変更する

つまり、監視する競合を指定するのはユーザーです。MCPを通じて、AIが収集済みのデータを分析します。

機能の詳細については、MCPツールの概要 →をご覧ください。

📊 Priceminderを選ぶ理由

昨日のデータではなく、リアルタイムです。 代替のMCPサーバーを含む多くの価格モニタリングツールは、T-1（前日キャッシュ）のデータを返します。Priceminderは価格を1日3回クロールするため、ほぼリアルタイムで状況を把握できます。

機能	代替MCPサーバー	Priceminder
データの鮮度	T-1（前日）	T-0（当日、1日3回）
価格変動の検出	翌日	4～8時間以内
フラッシュセール／7.7／9.9／11.11	日中の変動を見逃す	時間単位の価格変更を検知
プッシュ通知	❌ 問い合わせのみ	✅ Feishu／DingTalk／Telegram
セルフホスト可能	✅ 対応	✅ 対応

つまり、他のツールを使っている場合、昨日のデータをもとに判断していることになります。Priceminderなら、競合の価格変更を通知で受け取りながら、今まさに起きていることを把握できます。

🌟 機能 — 8 つの MCP ツール

#	ツール	説明	カテゴリ
1	`get_monitor_list`	追跡中のすべての商品を一覧表示します	🔍 クエリ
2	`get_price_summary`	追跡中のすべての商品の価格概要をまとめて表示します	🔍 クエリ
3	`get_price_history`	特定商品の価格履歴を時系列で表示します	🔍 クエリ
4	`get_alerts`	値下げアラートを一覧表示します	🔍 クエリ
5	`add_monitor`	監視リストに新しい商品を追加します	⚡ アクション
6	`update_monitor_status`	監視を一時停止または再開します	⚡ アクション
7	`get_crawl_health`	クローラーエンジンの稼働状況と統計を確認します	📊 インサイト
8	`get_monitor_overview`	すべての監視対象のダッシュボード概要を表示します	📊 インサイト

ツールの詳細なドキュメントはこちらをご覧ください：MCP ツールの概要 →

🚀 クイックスタート

拡張機能をインストール → 商品を追加 → MCP キーを取得 → AI クライアントを設定

スクリーンショット付きの手順を確認するには、公式ドキュメントをご覧ください：クイックスタートガイド →

ステップ 1：ブラウザー拡張機能をインストールする

ブラウザー	インストール方法
Chrome	Chrome ウェブストアで「Priceminder」を検索します
Edge	Edge アドオンで「Priceminder」を検索します
360 Browser	公式ウェブサイトからオフラインインストーラーをダウンロードします
Opera	Opera アドオンストア

スクリーンショットは拡張機能のインストールガイド →をご覧ください。

ステップ 2：監視する商品を追加する

Shopee の商品ページを開きます（SG/MY/TH/ID/TW/PH/VN に対応）。右上に「今すぐ監視」ボタンが表示されます。

**「今すぐ監視」**をクリック → 商品が監視リストに追加されます
システムが選択した間隔で価格データの収集を自動的に開始します
拡張機能の設定で、クロール頻度とアラートのしきい値を設定します

💡 **まず商品を監視対象にする必要があります。**監視対象がないと、AI に問い合わせても空の結果が返されます。まずは競合商品のページを 5～10 件以上追加してください。

ステップ 3：MCP キーを取得する

ブラウザーの拡張機能の設定ページを開きます。MCP キーは「MCP Configuration」セクションに表示されます。

⚠️ **MCP キーは拡張機能の設定画面内でのみ確認できます。**ウェブサイトへのログインからは取得できません。

ステップ 4：AI クライアントを設定する

対応 AI クライアント（HTTP モード — 推奨）：

クライアント	設定方法	チュートリアル
Cherry Studio	設定 → MCP → HTTP URL を追加	ガイド →
OpenClaw	config.yaml → mcp_servers → url	ガイド →
Claude Desktop	claude_desktop_config.json → mcpServers	ガイド →
Cursor	Cursor Settings → MCP → HTTP URL を追加	ガイド →
Cline	Cline MCP Config → 追加	ガイド →
Hermes Agent	config.yaml → mcp_servers	ガイド →

次の URL を追加します（*** を MCP キーに置き換えてください）。

{
  "mcpServers": {
    "sentinel": {
      "url": "https://priceminder.online/mcp_server?key=***"
    }
  }
}

スクリーンショット付きのクライアント設定ガイドはこちらをご覧ください：クライアント設定ガイド →

ステップ 5：接続を確認する

次の質問をして、設定をテストします。

プロンプト	呼び出されるツール	期待される結果
「何を監視していますか？」	`get_monitor_list`	現在の監視リスト
「競合相手の価格はどうなっていますか？」	`get_price_summary`	価格の概要（現在／基準／最高／最低／平均）
「新しい値下げアラートはありますか？」	`get_alerts`	未読の値下げ記録
「クローラーは正常に動作していますか？」	`get_crawl_health`	クローラーエンジンの状態

✅ AI が監視データを返したら、設定は完了です。

❌ 結果が空の場合は、先に拡張機能から商品を監視対象に追加したことを確認してください。

💬 プロンプトのシナリオ

実行できる実際のシナリオを3つ紹介します。それぞれ異なるユースケースを示しています。

1️⃣ 店舗単位の価格ウォッチ

「Shopee SG の Shopee 店舗『ABC Official Store』の商品をすべて監視してください。過去24時間以内に5％を超えて値下がりした商品があれば、変更内容を要約してください。」

AI エージェントは次の処理を行います。

この店舗の商品が監視リストにあるか確認します
最新のクロール価格を比較します
しきい値を下回った商品を返します

おすすめの用途： ブランド間の競争 — 特定の競合他社の全商品を把握できます。

2️⃣ フラッシュセール／キャンペーンのアラート

「7.7セール期間中は4時間ごとに確認し、追跡中の商品に3％以上の価格変動があれば通知してください。変更があった商品のみ表示してください。」

AI エージェントは次の処理を行います。

get_price_summary を呼び出し、現在の価格と以前の価格を取得します
変動率が3％以上の商品に絞り込みます
変更前後を分かりやすく比較して提示します

おすすめの用途： キャンペーン期間 — 競合他社が1時間ごとに価格を調整しているのに、昨日のデータを見てしまうことを防げます。

3️⃣ 値下がりの分析

「過去2日間の値下がりアラートをすべて表示してください。最も値下がりした商品はどれですか？10％を超える値下がりがあれば強調してください。」

AI エージェントは次の処理を行います。

get_alerts を呼び出し、最近の通知を取得します
大きく価格が変動した商品について get_price_history を呼び出し、背景情報を確認します
値下がり率で順位付けし、特に重要な変動を強調します

おすすめの用途： 購買判断 — 最大の割引を見つけられます。

実際のプロンプト例はこちらをご覧ください：シナリオとベストプラクティス →

🔗 n8n との連携

Priceminder には、すぐにインポートできる n8n ワークフローテンプレートが付属しています。

ファイル： priceminder-mcp-n8n.json

ワークフロー

Schedule ─► Get Price Summary ─► Parse Drops ─► Has Drops? ─┬► Telegram Alert
(4h cron)                                                     ├► Email Alert
                                                              └► Log (no drops)

インポート

n8n を開きます → ワークフロー → ファイルからインポート
priceminder-mcp-n8n.json を選択します
認証情報を設定します。
- SENTINEL_TOKEN（n8n ホスト上の環境変数）
- Telegram ボットトークンとチャット ID（任意）
- SMTP 認証情報（任意）
ワークフローを有効化します

🏗️ アーキテクチャ

┌─────────────────────────────────────────────────────┐
│                  AI Client                          │
│  (Claude Desktop / Cursor / Cherry Studio / Hermes) │
└──────────────┬──────────────────────────────────────┘
               │  MCP Protocol (stdio or HTTP/SSE)
               ▼
┌──────────────────────────────────────┐
│     Priceminder MCP Server           │
│  ┌────────────────────────────────┐  │
│  │  Tool Registry (8 tools)      │  │
│  │  - get_monitor_list           │  │
│  │  - get_price_summary          │  │
│  │  - get_price_history          │  │
│  │  - get_alerts                 │  │
│  │  - add_monitor                │  │
│  │  - get_crawl_health           │  │
│  │  - get_monitor_overview       │  │
│  └──────────────┬─────────────────┘  │
│                 │ HTTP + Token Auth
│  ┌──────────────▼─────────────────┐  │
│  │  API Client (httpx)           │  │
│  └──────────────┬─────────────────┘  │
└─────────────────┼────────────────────┘
                  │ HTTPS
┌─────────────────▼────────────────────┐
│     Priceminder REST API             │
│  (User Mgmt / Monitor / Price / Alert)│
└─────────────────┬────────────────────┘
                  │
┌─────────────────▼────────────────────┐
│     PostgreSQL 16                    │
│  (Price History / Users / Alerts)    │
└──────────────────────────────────────┘

データフロー

① User selects products to monitor via extension
      │
      ▼
② Backend fetches real-time prices via paid third-party API data services → PostgreSQL
      │
      ▼
③ MCP Server reads via API
      │
      ▼
④ AI client queries via MCP protocol

重要な点： データは一方向に流れます。ユーザーが商品を選択 → バックエンドが有料 API 経由で取得 → MCP が読み取ります。拡張機能は、監視する商品をシステムに伝えるだけです。

🔧 設定

環境変数

変数	説明	デフォルト
`SENTINEL_API_BASE`	バックエンド API のベース URL	`https://priceminder.online/shopee`
`SENTINEL_TOKEN`	認証トークン	（必須）
`SENTINEL_TIMEOUT`	HTTP リクエストのタイムアウト（秒）	`30`
`MCP_MODE`	実行モード：`stdio` または `http`	`stdio`
`MCP_HOST`	HTTP サーバーのバインドアドレス	`127.0.0.1`
`MCP_PORT`	HTTP サーバーのポート	`8082`
`LOG_LEVEL`	ログレベル	`INFO`

📡 API リファレンス

認証

すべての API 呼び出しで、次のヘッダーが必要です。

X-Api-Key: sentinel-mvp-2026
X-Sentinel-Token: YOUR_TOKEN

MCP キーの生成

curl -X POST https://priceminder.online/shopee/mcp/generate-key \
  -H "X-Api-Key: sentinel-mvp-2026" \
  -H "X-Sentinel-Token: YOUR_TOKEN"

🆓 Free と Pro の比較

機能	Free	Pro
アクティブな監視対象	最大5件	無制限
価格履歴	3日間	90日間
価格サマリー	3日間	90日間
呼び出し頻度	1時間あたり60回	無制限
リアルタイムアラート	—	✅
優先サポート	—	✅

今すぐアップグレード 👉 priceminder.online

🛠️ 開発

git clone https://github.com/haidrau/sentinel-mcp-server.git
cd sentinel-mcp-server

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
python -m pytest tests/

# Start in dev mode
export SENTINEL_TOKEN=your-test-token
python -m sentinel_mcp.server

📄 ライセンス

MIT License — 詳細は LICENSE をご覧ください。

🤝 貢献

貢献を歓迎します！お気軽にどうぞ。

バグや機能リクエストについて Issue を作成する
新しいツールや改善のための PR を送信する
ディスカッションで質問する

🌐 Links

Website: priceminder.online ← Sign up free
Official Docs: priceminder.online/docs
Quick Start: priceminder.online/docs/quick-start
MCP Tools Overview: priceminder.online/docs/tools/overview
GitHub: github.com/haidrau/sentinel-mcp-server
Gitee: gitee.com/haidrau/sentinel-mcp-server

Markdown 対応

ログインしてコメント

基本情報

作者: haidrau
バージョン: 0.2.0
トランスポート: sse
掲載日: 2026年7月11日
最終更新: 16 週間前
公式 Registry: io.github.haidrau/sentinel-mcp-server

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

sentinel-mcp-server

sentinel-mcp-server について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

Priceminder MCP Server

📌 重要：まずデータパイプラインをご確認ください

⚠️ 前提条件

🤖 AI機能の範囲

📊 Priceminderを選ぶ理由

🌟 機能 — 8 つの MCP ツール

🚀 クイックスタート

ステップ 1：ブラウザー拡張機能をインストールする

ステップ 2：監視する商品を追加する

ステップ 3：MCP キーを取得する

ステップ 4：AI クライアントを設定する

ステップ 5：接続を確認する

💬 プロンプトのシナリオ

1️⃣ 店舗単位の価格ウォッチ

2️⃣ フラッシュセール／キャンペーンのアラート

3️⃣ 値下がりの分析

🔗 n8n との連携

ワークフロー

インポート

🏗️ アーキテクチャ

データフロー

🔧 設定

環境変数

📡 API リファレンス

認証

MCP キーの生成

🆓 Free と Pro の比較

🛠️ 開発

📄 ライセンス

🤝 貢献

🌐 Links

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？