TradeMate Customer Discovery Skill

Search and discover potential foreign trade customers from the web.

Description

Automatically searches Google for potential buyers in your target market, extracts company information and contact details (email, phone, WhatsApp), and scores leads by relevance. Helps foreign trade professionals find new customers without manual browsing.

Triggers

"find customers" / "找客户"
"discover leads" / "发现潜在客户"
"search buyers" / "搜索买家"
"customer discovery" / "客户发现"

Workflow

1. Search for Potential Customers

POST /api/v1/discovery/search
Content-Type: application/json
Authorization: Bearer <token>

{
  "keyword": "<product or industry keyword>",
  "market": "US|UK|DE|FR|AU|...",  // target country code
  "max_results": 10
}

Response:

{
  "results": [
    {
      "title": "Company Name",
      "url": "https://company-website.com",
      "description": "...",
      "emails": ["info@company.com"],
      "phones": ["+1-xxx-xxx-xxxx"],
      "social": {
        "whatsapp": "...",
        "wechat": "..."
      },
      "relevance_score": 85
    }
  ],
  "total": 10
}

2. Save High-Scoring Leads

High-scoring leads (score >= 70) are automatically saved as Customer records in the TradeMate CRM via the Agent pipeline:

POST /api/v1/agent/start
Content-Type: application/json
Authorization: Bearer <token>

{
  "product_name": "<your product>",
  "product_description": "<product description>",
  "target_market": "<target country>"
}

Configuration

Requires a running TradeMate backend instance with:

Google Custom Search API configured
Valid API token with discovery credits

export TRADEMATE_API_URL=http://localhost:8000
export TRADEMATE_API_KEY=<your-api-token>

Notes

Each search consumes discovery credits (check balance via GET /api/v1/credits/balance)
Free tier: limited searches per day
Pro tier: expanded daily quota
Enterprise tier: unlimited searches + auto-save to CRM

2.0 KiB Raw Blame History