{
  "markdown": "# procureradar-mcp-server\n\n[![npm version](https://img.shields.io/npm/v/procureradar-mcp-server.svg)](https://www.npmjs.com/package/procureradar-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n\n**MCP server for [ProcureRadar](https://www.procureradar.com) (智猫 / Zhimao)** — find verified global **B2B buyers** (importers & distributors) by product category and country, then enrich contacts and run deep company intelligence. Think of it as the *buyer-side* counterpart to Alibaba: we surface **buyers for sellers**, not suppliers for buyers.\n\n> Operated by Acrometa Lifestyle Pte. Ltd., **listed on the Singapore Exchange (SGX)**. Neutral, PDPA-compliant data intermediary. Bilingual (English / 中文).\n\nThere are **two ways** to connect — pick one:\n\n## Option A — Remote MCP endpoint (recommended, zero install)\n\nThe hosted MCP endpoint supports an **anonymous handshake** and a **free, rate-limited discovery tool** (`find_buyers`) — you can try it without any credentials. Paid tools use OAuth 2.1 or a `Bearer zk_` key.\n\n**Cursor / Claude Desktop** (`~/.cursor/mcp.json` or Claude config):\n\n```json\n{\n  \"mcpServers\": {\n    \"procureradar\": {\n      \"url\": \"https://www.procureradar.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer zk_YOUR_TOKEN\" }\n    }\n  }\n}\n```\n\n**Gemini CLI** (note the `httpUrl` key):\n\n```json\n{\n  \"mcpServers\": {\n    \"procureradar\": {\n      \"httpUrl\": \"https://www.procureradar.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer zk_YOUR_TOKEN\" }\n    }\n  }\n}\n```\n\n> `find_buyers` works **without** a token (anonymous, free, rate-limited). Unlocking contact details / intelligence requires a `zk_` key or OAuth login.\n\n## Option B — Local stdio server (this npm package)\n\nRuns the published npm package over stdio with your own API key.\n\n**Cursor** (`~/.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"zhimao\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"procureradar-mcp-server\"],\n      \"env\": {\n        \"ZHIMAO_API_KEY\": \"zk_YOUR_TOKEN\",\n        \"ZHIMAO_BASE_URL\": \"https://www.procureradar.com\"\n      }\n    }\n  }\n}\n```\n\n### Get an API key\n\nCreate a `zk_` key at **https://www.procureradar.com/enterprise/api-access** (shown once — store it safely).\n\n## 🛠️ Tools\n\n| Tool | Purpose | Cost |\n|------|---------|------|\n| `query_expansion` | Supply-chain expansion → buyer personas + Boolean query | per registry |\n| `url_profile_extract` | URL → structured company profile (Readability + LLM) | 10 pts |\n| `social_harvest_assisted` | Generate a harvest bookmarklet (FB / Xiaohongshu / LinkedIn) | 10 pts |\n| `facebook_group_harvest` | FB group bulk bookmarklet | 10 pts |\n| `seed_url_bulk_ingest` | Bulk-ingest seed URLs | free |\n| `company_intelligence` | Company intelligence (registry / web / WHOIS / tax / map / logo / news) | 10 / 30 pts |\n| `decision_maker_intel` | Decision-maker discovery (LinkedIn + email + WhatsApp) | 10 / 25 pts |\n| `buyer_intent_intelligence` | Buyer-intent composite (customs + supply chain + region) | 20 / 40 pts |\n| `signal_watch` | Subscribe to hiring / news / tender signals | free |\n\nAll calls are **BYOK + real billing** — the `zk_` token is tied to your ProcureRadar account and charges your balance.\n\n## 💬 Example prompts\n\nOnce connected in your AI client, just ask in natural language:\n\n1. **Find buyers (free, anonymous)** — *\"Find verified flour importers and distributors in Malaysia.\"* → calls `find_buyers { category: \"flour\", country_iso: \"MY\" }`.\n2. **Enrich contacts (paid)** — *\"Get the email and WhatsApp for the importer example-importer.com.\"* → calls `enrich_buyer_contact { target_domain: \"example-importer.com\" }`.\n3. **Company intelligence (paid)** — *\"Run a company intelligence check on example-importer.com in Malaysia and give me a risk score.\"* → calls `analyze_buyer_intelligence { target_domain: \"example-importer.com\", country_iso: \"MY\" }`.\n\n> `find_buyers` is free and works without any credentials, so you can try example 1 immediately.\n\n## 🔒 Security\n\n- `zk_` tokens are shown once at creation; the DB stores only `sha256(token + salt)`.\n- Up to 10 active keys per user; revoke unused ones from your account.\n\n## 🐛 Debug\n\n```bash\nZHIMAO_API_KEY=zk_xxx ZHIMAO_BASE_URL=https://www.procureradar.com npx procureradar-mcp-server\n```\n\nWaits for MCP messages over stdio; `Ctrl+C` to exit.\n\n## Build from source\n\n```bash\nnpm install\nnpm run build      # outputs dist/\nnode dist/index.js\n```\n\n## Links\n\n- Website: https://www.procureradar.com\n- API access: https://www.procureradar.com/enterprise/api-access\n- Remote MCP endpoint: https://www.procureradar.com/api/mcp\n- npm: https://www.npmjs.com/package/procureradar-mcp-server\n\n## 📜 License\n\n[MIT](./LICENSE)\n",
  "bytes": 4716,
  "sha": "fcbfa98b8b5ef207f6f39b4bde403126af623b1e0f45a1e713f73c445ce9a29e",
  "repo_slug": "tonyback0101-cmyk/procureradar-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tonyback0101_cmyk_buyer_intell_400d929c/readme"
}