io.github.haidrau/sentinel-mcp-server

Priceminder MCP Server

**中文** | English

Priceminder — Real-time Shopee competitor price monitoring, powered by AI agents through the Model Context Protocol (MCP).

🌐 Sign up free: priceminder.online

Monitor competitor prices across Shopee Southeast Asia (SG, MY, TH, VN, ID, PH). Let your AI agent track, analyze, and alert on price movements — all through natural language.

📌 Important: Understand the Data Pipeline First

Priceminder's MCP service does not work standalone. It depends on competitor price data obtained through paid third-party API data services. Please understand this 3-layer pipeline before using:

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

⚠️ Prerequisites

🔑 Where to get your MCP Key? The MCP Key is displayed in the browser extension settings page. No extension → No Key → No MCP service. The website registration (priceminder.online) is for account management and Pro upgrades — the MCP access credential lives inside the extension.

🤖 AI Capability Boundaries

Priceminder's MCP tools can only query products you've manually added to your monitoring list. It cannot arbitrarily search all of Shopee.

In short: You tell the system which competitors to watch, MCP lets AI analyze what's been collected.

For full capability details, see the **MCP Tools Overview →**

📊 Why Priceminder?

Real-time, not yesterday. Most price monitoring tools — including alternative MCP servers — return T-1 (yesterday's cached) data. Priceminder crawls prices 3 times daily, giving you near-real-time visibility.

In short: If you're using other tools, you're making decisions on yesterday's data. Priceminder tells you what's happening right now — and pushes alerts when competitors move.

🌟 Features — 8 MCP Tools

See the full tool documentation here: **MCP Tools Overview →**

🚀 Quick Start

Install Extension → Add Products → Get MCP Key → Configure AI Client

For visual step-by-step guide with screenshots, see the official docs: **Quick Start Guide →**

Step 1: Install the Browser Extension

See **Extension Installation Guide →** for screenshots.

Step 2: Add Products to Monitor

Open any Shopee product page (supports SG/MY/TH/ID/TW/PH/VN). A "Monitor Now" button will appear at the top-right:

1. Click "Monitor Now" → product added to your monitor list
2. The system automatically starts collecting price data at your chosen interval
3. Configure crawl frequency and alert thresholds in the extension settings

💡 You need monitored products first. Without them, the AI will return empty results when queried. Start by adding at least 5–10 competitor products.

Step 3: Get Your MCP Key

Open the browser extension settings page. Your MCP Key is displayed in the "MCP Configuration" section.

⚠️ The MCP Key is only visible inside the extension settings. It is not available from the website login.

Step 4: Configure Your AI Client

Supported AI Clients (HTTP mode — recommended):

Add this URL (replace *** with your MCP Key):

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

For detailed client setup guides with screenshots, see: **Client Setup Guides →**

Step 5: Verify the Connection

Test your setup by asking these questions:

✅ If the AI returns your monitoring data, setup is successful.

❌ If results are empty, make sure you've added products to monitor via the extension first.

💬 Prompt Scenarios

Here are 3 real-world scenarios you can run — each demonstrates a different use case:

1️⃣ Store-Level Price Watch

"Monitor all products from Shopee store 'ABC Official Store' on Shopee SG. If any product drops more than 5% in the last 24 hours, summarize the changes."

Your AI agent will:

1. Check your monitor list for this store's products
2. Compare latest crawl prices
3. Return products that dropped below the threshold

Best for: Brand competition — keep tabs on a specific competitor's entire catalog.

2️⃣ Flash Sale / Campaign Alert

"Check every 4 hours during the 7.7 sale — alert me if any of my tracked products have a price change of 3% or more. Show only the products that changed."

Your AI agent will:

1. Call get_price_summary to get current vs previous prices
2. Filter for products with ≥3% movement
3. Present a clean before/after comparison

Best for: Campaign periods — don't wake up to yesterday's data when competitors adjust prices hourly.

3️⃣ Price Drop Intelligence

"Show me all price drop alerts from the last 2 days. Which products dropped the most? Highlight any drops over 10%."

Your AI agent will:

1. Call get_alerts for recent notifications
2. Call get_price_history on the biggest movers for context
3. Rank by drop percentage and highlight critical moves

Best for: Buying decisions — spot the deepest discounts.

More real-world prompt examples: **Scenarios & Best Practices →**

🔗 n8n Integration

Priceminder ships with a ready-to-import n8n workflow template.

File: priceminder-mcp-n8n.json

Workflow

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

Import

1. Open n8n → Workflows → Import from File
2. Select priceminder-mcp-n8n.json
3. Configure credentials:
   • SENTINEL_TOKEN (env var on the n8n host)
   • Telegram bot token + chat ID (optional)
   • SMTP credentials (optional)
4. Activate the workflow

🏗️ Architecture

┌─────────────────────────────────────────────────────┐
│                  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)    │
└──────────────────────────────────────┘

Data Flow

① 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

Key point: Data flows one way — user selects products → backend fetches via paid APIs → MCP reads. The extension only tells the system which products to watch.

🔧 Configuration

Environment Variables

📡 API Reference

Authentication

All API calls require these headers:

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

Generate MCP Key

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

🆓 Free vs Pro

Upgrade now 👉 priceminder.online

🛠️ Development

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

📄 License

MIT License — see LICENSE for details.

🤝 Contributing

Contributions are welcome! Feel free to:

• Open issues for bugs or feature requests
• Submit PRs for new tools or improvements
• Ask questions in the discussions

🌐 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