io.github.tonyback0101-cmyk/buyer-intelligence

Official13 tools

by tonyback0101-cmyk · JavaScript

Find verified global B2B buyers by category & country. Free anonymous discovery. SGX-listed.

Find verified global B2B buyers by category and country with free anonymous discovery.

Topics

ai-agentsb2bbuyer-intelligencelead-generationmcpmcp-servermodel-context-protocolsales-intelligenceprocureradar

Captured live from the server via tools/list.

find_buyers

Search 500,000+ verified importers and distributors by product category and target country. Returns company profiles + a `coverage` object. When in-database coverage is thin (empty/partial), the response includes an `acquisition` task (task_id) — a background crawl is started automatically (free). Poll it with check_discovery_task until status=completed to get freshly gathered buyers. Contact details are not included — use enrich_buyer_contact to get them.

Parameters (4)

categorystringrequired
Product category (e.g. 'flour', 'stainless steel tableware', 'LED lighting')
country_isostring
ISO 3166-1 alpha-2 country code (e.g. MY, ID, KE, AE, GB)
quality_gradestring
Filter by data quality. 'premium' = verified contact + multi-source evidence.
limitnumber
Max results to return (default 20, max 100)

enrich_buyer_contact

Run 6-layer contact enrichment for a buyer: direct website scraping → proxy retry → BFS contact pages → LLM text extraction → vision screenshot → Serper fallback. Returns email, phone, WhatsApp, decision-maker names. Costs Zhimao Points.

Parameters (2)

target_domainstringrequired
Buyer's website domain (e.g. 'example-importer.com')
target_company_namestring
Buyer's company name

analyze_buyer_intelligence

Deep company intelligence for a buyer: corporate registry verification, customs import records, supply chain mapping, decision-maker profiling, risk flags. Returns 0-100 score with evidence chain.

Parameters (3)

target_domainstringrequired
Buyer's website domain
target_company_namestring
Buyer's company name
country_isostring
ISO 3166-1 alpha-2 country code

submit_discovery_job

Explicitly submit an async batch buyer discovery job for a category + country. Returns a job_id; poll it with check_discovery_task until status=completed. Note: find_buyers already auto-starts a background crawl when coverage is thin, so usually you only need this for a forced/fresh deep crawl.

Parameters (3)

categorystringrequired
Product category to discover buyers for
country_isostringrequired
Target country ISO code
keywordsarray
Additional keywords to refine the search

check_discovery_task

Poll a background buyer-discovery task created by find_buyers (acquisition.task_id) or submit_discovery_job. Returns status (working | completed | failed); when completed, includes the freshly gathered buyers. Use exponential backoff (start ~20s) and stop polling once status is completed or failed. Free.

Parameters (2)

task_idstringrequired
The task_id returned in find_buyers' acquisition field, or a discovery job_id
limitnumber
Max buyers to return when completed (default 50, max 100)

list_group_buy_pools

List open collective sourcing projects (联拼宝 / Lianpinbao). Multiple suppliers co-sell into shared buyer pools, reducing per-supplier MOQ. Find pools where you can join to access existing buyer demand.

Parameters (2)

categorystring
Filter by product category keyword (optional)
statusstring
Pool status (default: open)

search_products

Search live products listed by ProcureRadar suppliers by keyword, destination country, supplier country, or category. Returns product_id values needed to request a quote. Free & anonymous (IP rate-limited). This is the first step of the buyer-side transaction loop: search_products → request_quote → list_quotes → place_order.

Parameters (5)

qstring
Keyword (product title / SKU / supplier name)
country_isostring
Destination country ISO2 (filters by deliverable SKUs)
supplier_countrystring
Supplier origin country ISO2
categorystring
Category code (mall_category_code), optional
limitnumber
Max results (default 20, max 50)

search_stores

Discover verified supplier storefronts (supply nodes) on ProcureRadar by target-market country and industry. Each store groups multiple products from one verified supplier and returns sample_product_ids you can quote on. Use this to find a supplier store first, then search_products / request_quote. Free & anonymous (IP rate-limited). Organizing principle: country × industry matrix.

Parameters (4)

countrystring
Target-market country ISO2 the store operates/sells into (e.g. MY, VN, JP)
industrystring
Industry key (85-industry taxonomy, aligns with product category codes, e.g. 'beauty_personal_care')
qstring
Store name keyword (optional)
limitnumber
Max results (default 20, max 50)

request_quote

Start a transaction by sending a quote request (inquiry) to a supplier for a specific product_id (get one from search_products). Returns an inquiry_id. Requires authentication — the inquiry is owned by the authenticated buyer. The supplier then submits a quote; poll it with list_quotes.

Parameters (6)

product_idstringrequired
Product id to request a quote for (from search_products)
quantitynumber
Desired quantity (optional)
quantity_unitstring
Unit for the quantity, e.g. 'pcs', 'kg' (optional)
buyer_notestring
Free-text note to the supplier (optional)
destination_countrystring
Destination country ISO2 (optional)
destination_citystring
Destination city (optional)

list_quotes

List the supplier quotes submitted for one of your inquiries (from request_quote). Returns each quote's id, unit price, total, MOQ, lead time and validity, plus acceptable_quote_ids you can pass to place_order. Requires authentication; only the inquiry's buyer (or the product's supplier) may read it.

Parameters (1)

inquiry_idstringrequired
The inquiry_id returned by request_quote

place_order

Accept a supplier quote and create an order (status pending_payment) for one of your inquiries. Pass the inquiry_id and the chosen quote_id (from list_quotes' acceptable_quote_ids). Optionally pass a mandate_id (from create_payment_mandate) to auto-authorize the order against an AP2 payment mandate within its limits — the response then includes mandate_authorization (authorized/declined + reason). Returns the order id, order_no and a payment next_step. Idempotent per inquiry: re-calling returns the existing order. Requires authentication.

Parameters (3)

inquiry_idstringrequired
The inquiry_id (from request_quote / list_quotes)
quote_idstringrequired
The quote_id to accept (from list_quotes' acceptable_quote_ids)
mandate_idstring
Optional AP2 payment mandate id (from create_payment_mandate) to auto-authorize this order within pre-approved limits.

create_payment_mandate

Create an AP2 payment mandate: a pre-authorization that lets your agent place orders autonomously (human-not-present) within strict limits — total budget, optional per-order cap, currency, optional seller/category scope, and expiry. Returns a mandate_id to pass to place_order. Each order authorized against it is recorded as a verifiable intent and decrements the budget. Requires authentication.

Parameters (6)

max_total_amountnumberrequired
Total spend budget for this mandate (required, > 0)
currencystring
Currency, e.g. USD (default USD). Must match the order currency to authorize.
max_per_order_amountnumber
Optional per-order cap
category_scopearray
Optional list of allowed category codes (mall_category_code). Omit = any category.
seller_scopearray
Optional list of allowed seller_user_id UUIDs. Omit = any seller.
expires_atstring
Optional ISO timestamp after which the mandate is no longer valid.

list_payment_mandates

List your AP2 payment mandates with status, currency, total/per-order limits, consumed and remaining budget, scope and expiry. Requires authentication.

No parameters.

README.md5 KBView on GitHub

procureradar-mcp-server

MCP server for ProcureRadar (智猫 / 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.

Operated by Acrometa Lifestyle Pte. Ltd., listed on the Singapore Exchange (SGX). Neutral, PDPA-compliant data intermediary. Bilingual (English / 中文).

There are two ways to connect — pick one:

Option A — Remote MCP endpoint (recommended, zero install)

The 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.

Cursor / Claude Desktop (~/.cursor/mcp.json or Claude config):

json

{
  "mcpServers": {
    "procureradar": {
      "url": "https://www.procureradar.com/api/mcp",
      "headers": { "Authorization": "Bearer zk_YOUR_TOKEN" }
    }
  }
}

Gemini CLI (note the httpUrl key):

json

{
  "mcpServers": {
    "procureradar": {
      "httpUrl": "https://www.procureradar.com/api/mcp",
      "headers": { "Authorization": "Bearer zk_YOUR_TOKEN" }
    }
  }
}

find_buyers works without a token (anonymous, free, rate-limited). Unlocking contact details / intelligence requires a zk_ key or OAuth login.

Option B — Local stdio server (this npm package)

Runs the published npm package over stdio with your own API key.

Cursor (~/.cursor/mcp.json):

json

{
  "mcpServers": {
    "zhimao": {
      "command": "npx",
      "args": ["-y", "procureradar-mcp-server"],
      "env": {
        "ZHIMAO_API_KEY": "zk_YOUR_TOKEN",
        "ZHIMAO_BASE_URL": "https://www.procureradar.com"
      }
    }
  }
}

Get an API key

Create a zk_ key at https://www.procureradar.com/enterprise/api-access (shown once — store it safely).

🛠️ Tools

Tool	Purpose	Cost
`query_expansion`	Supply-chain expansion → buyer personas + Boolean query	per registry
`url_profile_extract`	URL → structured company profile (Readability + LLM)	10 pts
`social_harvest_assisted`	Generate a harvest bookmarklet (FB / Xiaohongshu / LinkedIn)	10 pts
`facebook_group_harvest`	FB group bulk bookmarklet	10 pts
`seed_url_bulk_ingest`	Bulk-ingest seed URLs	free
`company_intelligence`	Company intelligence (registry / web / WHOIS / tax / map / logo / news)	10 / 30 pts
`decision_maker_intel`	Decision-maker discovery (LinkedIn + email + WhatsApp)	10 / 25 pts
`buyer_intent_intelligence`	Buyer-intent composite (customs + supply chain + region)	20 / 40 pts
`signal_watch`	Subscribe to hiring / news / tender signals	free

All calls are BYOK + real billing — the zk_ token is tied to your ProcureRadar account and charges your balance.

💬 Example prompts

Once connected in your AI client, just ask in natural language:

Find buyers (free, anonymous) — "Find verified flour importers and distributors in Malaysia." → calls find_buyers { category: "flour", country_iso: "MY" }.
Enrich contacts (paid) — "Get the email and WhatsApp for the importer example-importer.com." → calls enrich_buyer_contact { target_domain: "example-importer.com" }.
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" }.

find_buyers is free and works without any credentials, so you can try example 1 immediately.

🔒 Security

zk_ tokens are shown once at creation; the DB stores only sha256(token + salt).
Up to 10 active keys per user; revoke unused ones from your account.

🐛 Debug

bash

ZHIMAO_API_KEY=zk_xxx ZHIMAO_BASE_URL=https://www.procureradar.com npx procureradar-mcp-server

Waits for MCP messages over stdio; Ctrl+C to exit.

Build from source

bash

npm install
npm run build      # outputs dist/
node dist/index.js

📜 License

MIT

Install

claude_desktop_config.json

{
  "mcpServers": {
    "buyer-intelligence": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.procureradar.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

find_buyers

enrich_buyer_contact

analyze_buyer_intelligence

submit_discovery_job

check_discovery_task

list_group_buy_pools

search_products

search_stores

request_quote

list_quotes

place_order

create_payment_mandate

list_payment_mandates

procureradar-mcp-server

Option A — Remote MCP endpoint (recommended, zero install)

Option B — Local stdio server (this npm package)

Get an API key

🛠️ Tools

💬 Example prompts

🔒 Security

🐛 Debug

Build from source

Links

📜 License

Install