feat: add product strategy, agent skills (3 SKILL.md), and Chrome browser extension

2026-06-24 10:37:58 +08:00
parent 2ccaafe470
commit 7b03d803b5
19 changed files with 2279 additions and 0 deletions
@@ -0,0 +1,85 @@
+# 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