# 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:
```json
{
  "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

```bash
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