Skill: wangm-a3/skill-customs (version 1.0.3)

--- name: yunlv-customs-scout description: >- Use when user needs to find import/export trade data, competitor customers, or market intelligence from customs data. Use when searching for active buyers of specific products in target markets. Use when performing competitor client mining via trade records. Use when user mentions "海关数据", "进出口数据", "采购商", "竞争对手客户", "挖客户", "贸易数据", "Import Intel". homepage: https://yunlvai.com license: MIT-0 version: 1.0.0 progressive: layers: - name: metadata tokens: 200 loaded: startup description: "技能基础配置、数据源说明、定价信息" - name: instructions tokens: 4000 loaded: trigger description: "海关数据挖掘全流程、评分算法、输出格式、触达策略" - name: resources tokens: variable loaded: on-demand description: "数据过滤规则、客户评分模型、触达话术库" resource_paths: - references/data_filter_rules.md - references/customer_scoring_model.md - references/outreach_templates.md metadata: yunlv: homepage: https://yunlvai.com primaryEnv: TRADEGPT_API_KEY category: customer-development subCategory: customs-data-mining tags: ["海关数据", "进出口数据", "贸易情报", "竞品客户挖掘", "B2B外贸", "采购商发现"] requires: env: - TRADEGPT_API_KEY bins: - python3 apis: - name: 云旅AI MatchGPT API url: https://api.yunlvai.com purpose: "海关贸易数据查询与智能匹配" auth: Bearer Token (TRADEGPT_API_KEY) - name: 全球海关数据 url: https://data.yunlvai.com purpose: "228+国家进出口贸易记录数据源" auth: Bearer Token emoji: "🔍" author: "云旅AI团队" pricing: free: features: ["每天5次免费查询", "基础贸易数据", "近3个月记录"] basic: price: 599 currency: CNY period: month features: ["每月500次查询", "完整联系方式", "决策人挖掘", "邮件触达"] pro: price: 1999 currency: CNY period: month features: ["无限查询", "竞品客户分析", "采购预测", "WhatsApp+邮件双通道触达"] triggers: - "海关数据" - "进出口记录" - "竞争对手客户" - "挖采购商" - "竞品分析" - "贸易情报" - "进口商查询" - "采购记录" - "customs data" - "trade intelligence" --- # 海关数据智能获客：竞品客户挖掘与贸易情报 > 海关数据是全球贸易的"数字金矿"，每笔进出口记录都包含采购商、供应商、产品规格、交易量和金额等关键信息。云旅AI海关数据智能获客技能，帮助外贸企业从228+国家的真实贸易记录中精准定位目标采购商，追踪竞品客户动态，抢占市场先机。 --- ## 一、技能定位 **解决什么问题**：如何从海量海关数据中找到真实活跃的采购商，并从竞争对手手中抢夺客户？ **核心价值**：将"盲目开发"升级为"精准狙击"，客户开发效率提升 **400%**。 --- ## 二、能做什么 ### 【核心功能】 | 功能 | 说明 | |------|------| | 采购商发现 | 按产品/HS编码/国家发现真实采购商及采购量 | | 竞品客户挖掘 | 输入竞争对手名称，挖掘其所有客户及合作深度 | | 贸易轨迹追踪 | 追踪目标采购商的采购周期、供应商变更趋势 | | 供应链可视化 | 呈现采购商的完整供应商结构和市场份额 | | 采购需求预测 | 基于历史数据预测未来3-6个月采购窗口期 | | 智能触达 | 自动生成个性化开发信，通过邮件/WhatsApp触达 | | 竞争态势分析 | 分析目标市场的供应商格局、竞争强度、进入机会 | ### 【数据覆盖】 - 国家覆盖：228+ 国家/地区 - 贸易记录：320万+ 条年度贸易记录 - 企业数据：280万+ 海外采购商画像 - 产品品类：全品类覆盖（支持HS编码精确查询） --- ## 三、操作步骤 ### 第1步：选择查询模式 **模式A - 产品/HS编码查询（最常用）** ``` 查询条件： - 产品关键词：LED panel light 或 HS编码：9405.11 - 目标市场：United States - 时间范围：近12个月 - 采购量筛选：年进口额≥$100,000 ``` **模式B - 竞争对手客户挖掘** ``` 查询条件： - 竞争对手公司：Philips Lighting - 目标市场：Europe - 想挖的客户类型：年采购额>50万美元的活跃客户 ``` **模式C - 特定采购商深度调研** ``` 查询条件： - 目标采购商公司名：Acme Lighting Corp - 调研维度：采购历史、供应商结构、采购周期 ``` ### 第2步：AI智能分析与筛选 系统自动执行： 1. **数据召回**：从228+国家海关数据库召回所有匹配记录 2. **信息补全**：匹配企业名称、联系方式、社交媒体、决策人 3. **评分排序**：MatchGPT从采购规模、活跃度、竞品依赖度、进入机会4维度评分 4. **竞品关系分析**：识别该采购商当前的供应商构成及合作深度 5. **触达时机推荐**：基于采购周期预测最佳接触时间窗口 ### 第3步：输出结构化情报报告 ```json { "query_type": "competitor_mining", "competitor": "Philips Lighting", "target_market": "United States", "date_range": "last_12_months", "total_importers_found": 234, "active_importers": 187, "high_opportunity": 42, "top_opportunities": [ { "rank": 1, "importer_name": "LumaMax Lighting Inc.", "country": "United States", "annual_import_value": "$4.5M", "import_frequency": "monthly", "current_suppliers": ["Philips ($3.2M)", "Osram ($0.8M)", "Others ($0.5M)"], "opportunity_score": 9.4, "why_vulnerable": "Philips占比71%，单一供应商依赖风险高，且我司价格优势约25%", "recommended_action": "以价格+样品切入，重点强调非Philips替代方案", "best_contact_window": "Q2采购淡季（4-5月），提前1个月触达", "contact_person": "Sarah Chen", "contact_role": "VP of Procurement", "email": "[REDACTED_SECRET]", "phone": "+1-555-0188" } ] } ``` ### 第4步：一键触达 - **邮件开发信**：基于竞品替代逻辑生成个性化邮件（英文/德文/法文等） - **WhatsApp触达**：针对美国/东南亚市场优先使用WhatsApp - **LinkedIn连接**：针对决策人直接发送LinkedIn连接请求 - **跟进序列**：设置多轮跟进序列（3-7-15天），未读自动触发 --- ## 四、适用场景 | 场景 | 使用方式 | |------|----------| | 新市场开拓 | 搜索某产品在某国家的所有采购商，按量级筛选 | | 竞品客户抢夺 | 输入竞品名称，系统挖掘其所有客户及合作机会 | | 现有客户深挖 | 追踪老客户的供应商变化趋势，预警流失风险 | | 定价策略制定 | 了解目标市场的价格区间和竞品定价 | | 展会前预判 | 参展前用海关数据预判哪些采购商会参展 | | 供应商替代侦察 | 反向分析：我司的哪些客户被竞争对手挖角 | --- ## 五、资源索引 - **海关数据过滤规则**: 见 `references/data_filter_rules.md`（何时读取：需要自定义数据筛选条件时） - **客户评分模型**: 见 `references/customer_scoring_model.md`（何时读取：理解评分逻辑或调整权重时） - **竞品挖掘触达话术**: 见 `references/outreach_templates.md`（何时读取：生成竞品替代类开发信时） --- ## 六、注意事项 ### ⚠️ 数据合规 - 海关数据仅用于B2B外贸合法商业开发 - 禁止将数据用于销售名单交易或非法竞争 - 各国数据开放程度不同，实际覆盖率视目标市场而定 ### ⚠️ 联系方式准确性 - 联系方式匹配率约 65-75%，高价值客户建议用LinkedIn二次验证 - 决策人信息每周更新，建议重要客户每月复核 ### ⚠️ 触达策略 - 竞品替代类话术效果最佳，但需确保产品对比数据准确 - 邮件发送遵守GDPR/CAN-SPAM规范 --- ## 七、使用示例 ### 示例 1：挖掘美国LED照明采购商 **用户需求**：我们是做LED面板灯的，挖掘近一年在美国市场年采购量超50万美元的采购商 **执行结果**： - 查询到 187 家活跃采购商 - 高机会评分（≥8分）42 家，首选推荐 15 家 - 输出每家公司的采购量、供应商结构、触达窗口和联系方式 ### 示例 2：抢夺Philips的欧洲客户 **用户需求**：Philips是我们最大的竞争对手，挖掘他们在欧洲的主要客户 **执行结果**： - 识别 Philips 在欧洲的 156 家活跃客户 - 其中 23 家采购量超 200 万美元 - 分析每家的供应商依赖度和可切入角度 - 生成针对性的竞品替代开发信模板 --- ## 八、Common Rationalizations | Rationalization | Reality | |----------------|---------| | "海关数据包含所有采购商联系方式" | 联系方式匹配率约65-75%，中东/非洲覆盖率更低 | | "从竞品手里挖客户很容易" | 需明确差异化优势，单纯价格战效果有限 | | "采购量大就等于好客户" | 需综合考虑付款周期、账期要求、合规成本 | | "海关数据实时更新" | 不同国家数据延迟1-6个月，美国数据最及时 | --- ## 九、Verification 完成海关数据客户挖掘流程后： - [ ] 确认查询条件精准（产品/竞品/市场三要素至少两项明确） - [ ] 验证评分逻辑（4个维度均有数据支撑，非主观臆断） - [ ] 确认供应链分析准确（供应商份额之和约等于100%） - [ ] 触达话术符合竞品替代逻辑（数据对比准确） - [ ] 触达策略符合GDPR/CAN-SPAM规范 - [ ] 已设置跟进提醒，避免首次触达后无后续 --- ## 十、Security & Privacy ### 存储根路径 ``` ./data/yunlv-skills/customsScout/ ├── queries/ # 查询历史记录 ├── reports/ # 生成的情报报告 ├── leads/ # 导出的客户名单 ├── outreach/ # 触达记录和开发信 └── logs/ # 运行日志 ``` ### 数据处理原则 - **本地处理**：查询条件和企业中转数据仅在本地处理 - **敏感数据保护**：API密钥和批量联系人数据不写入日志 - **数据时效**：海关数据默认保留近24个月，逾期自动归档 ### 权限边界声明 - ✅ **允许**：读取 `./skills/yunlv-skills/references/` 下的参考文件 - ✅ **允许**：调用云旅AI海关数据API获取贸易记录 - ✅ **允许**：写入 `./data/yunlv-skills/customsScout/leads/` 导出名单 - ✅ **允许**：通过邮件/WhatsApp/LinkedIn通道触达目标客户（需用户授权） - ❌ **禁止**：将海关数据用于销售名单交易或第三方数据服务 - ❌ **禁止**：抓取未授权的第三方数据源

path: clawhub.yaml
content: name: yunlv-customs-scout
version: 1.0.2
license: MIT-0
type: openclaw-skill
description: Use when user needs to find import/export trade data, competitor customers,
  or market intelligence from customs data. Use when searching for active buyers of
  specific products in target markets. Use when performing competitor client mining
  via trade records. Use when user mentions "海关数据", "进出口数据", "采购商", "竞争对手客户", "挖客户",
  "贸易数据", "Import Intel".
emoji: 🤖
homepage: https://yunlvai.com
publisher:
  name: 云旅AI团队
  website: https://yunlvai.com
required_env:
- TRADEGPT_API_KEY
primary_env: TRADEGPT_API_KEY
apis:
- name: 云旅AI MatchGPT API
  url: https://api.yunlvai.com
  purpose: 海关贸易数据查询与智能匹配
  auth: Bearer Token (TRADEGPT_API_KEY)
category: customer-development
tags:
- 海关数据
- 进出口数据
- 贸易情报
- 竞品客户挖掘
- B2B外贸
- 采购商发现
triggers:
- 海关数据
- 进出口记录
- 竞争对手客户
- 挖采购商
- 竞品分析
- 贸易情报
- 进口商查询
- 采购记录
- customs data
- trade intelligence
pricing:
  free:
    features:
    - 每天5次免费查询
    - 基础贸易数据
    - 近3个月记录
  basic:
    price: 599
    currency: CNY
    period: month
    features:
    - 每月500次查询
    - 完整联系方式
    - 决策人挖掘
    - 邮件触达
  pro:
    price: 1999
    currency: CNY
    period: month
    features:
    - 无限查询
    - 竞品客户分析
    - 采购预测
    - WhatsApp+邮件双通道触达


path: references/customer_scoring_model.md
content: # 客户评分模型

## MatchGPT评分体系

### 评分维度（总分10分）

#### 1. 产品匹配度 (0-3分)
| 评分 | 条件 |
|-----|------|
| 3分 | 完全匹配我方产品线，无缝对接 |
| 2分 | 主要产品匹配，部分需调整 |
| 1分 | 小部分匹配，需较大产品调整 |
| 0分 | 产品不匹配 |

#### 2. 采购规模 (0-3分)
| 评分 | 年采购额条件 |
|-----|--------------|
| 3分 | >$500,000 |
| 2分 | $100,000-$500,000 |
| 1分 | $50,000-$100,000 |
| 0分 | <$50,000 |

#### 3. 竞品依赖度 (0-2分)
| 评分 | 条件 |
|-----|------|
| 2分 | 当前供应商单一，我方有明显优势 |
| 1分 | 多供应商，我方有一定竞争力 |
| 0分 | 现有供应商稳定，我方优势不明显 |

#### 4. 进入机会 (0-2分)
| 评分 | 条件 |
|-----|------|
| 2分 | 采购周期窗口正好，客户有明确需求 |
| 1分 | 有一定机会，需培育 |
| 0分 | 时机不佳或信息不足 |

---

## 综合评分标准

| 总分 | 等级 | 建议行动 |
|-----|------|---------|
| 8-10分 | A级（高优先级）| 立即跟进，重点开发 |
| 6-7分 | B级（次优先级）| 积极跟进，保持联系 |
| 4-5分 | C级（观察）| 放入资源池，持续关注 |
| <4分 | D级（低优先级）| 暂不开发 |

---

## 评分流程

1. **数据收集**：获取客户基本信息和交易记录
2. **初步筛选**：过滤明显不匹配客户
3. **四维评分**：按上述维度逐一打分
4. **综合计算**：汇总得分，确定等级
5. **人工复核**：高风险客户需人工确认


path: references/data_filter_rules.md
content: # 数据过滤规则

## 一、数据质量筛选

### 1. 基本筛选条件
- [ ] 企业名称完整（非缩写或模糊名称）
- [ ] 至少包含以下之一：国家/地区、联系方式、交易记录
- [ ] 非重复记录（去重处理）

### 2. 活跃度筛选
| 活跃等级 | 定义 | 建议 |
|---------|------|------|
| 高活跃 | 近6个月有交易记录 | 优先开发 |
| 中活跃 | 6-12个月有交易记录 | 次优先 |
| 低活跃 | 12个月以上无记录 | 谨慎开发 |

### 3. 采购量筛选
| 年采购额 | 分类 | 建议 |
|---------|------|------|
| >$1M | 超大客户 | 重点开发 |
| $500K-$1M | 大客户 | 优先开发 |
| $100K-$500K | 中客户 | 标准开发 |
| <$100K | 小客户 | 资源有限可跳过 |

---

## 二、数据来源验证

### 可靠数据源
- 官方海关数据库（直接来源）
- 政府公开数据平台
- 经认证的贸易数据提供商

### 需验证的数据源
- 商业数据库（需交叉验证）
- 展会登记数据（需补充联系方式）
- 第三方平台数据（需谨慎）

---

## 三、联系方式筛选

### 联系方式完整性
| 字段 | 必要性 |
|-----|--------|
| 公司名称 | 必填 |
| 国家/地区 | 必填 |
| 邮箱 | 优先（有则标注） |
| 电话 | 优先（有则标注） |
| LinkedIn | 可选（有助于决策人挖掘） |

### 联系方式有效性检测
- 邮箱格式验证（@domain.com）
- 电话号码格式验证（国家代码）
- LinkedIn URL格式验证

---

## 四、竞品客户识别

### 竞品关联度
| 关联类型 | 权重 | 说明 |
|---------|------|------|
| 直接竞品 | 高 | 同类产品供应商 |
| 间接竞品 | 中 | 替代品供应商 |
| 潜在竞品 | 低 | 未来可能进入该领域 |

### 客户依赖度评估
| 依赖度 | 特征 | 开发难度 |
|-------|------|---------|
| 高依赖 | 单一供应商，合作多年 | 困难 |
| 中依赖 | 2-3个主要供应商 | 中等 |
| 低依赖 | 多供应商分散采购 | 较易 |


path: references/outreach_templates.md
content: # 开发信模板库

## 一、展会开发信

### 模板1：展会现场即时触达
```
Subject: Great meeting you at Canton Fair - [Company Name] outdoor furniture

Hi [Name],

It was a pleasure meeting you at Canton Fair [届数] today! 

I really enjoyed our conversation about [讨论话题]. As mentioned, I'm sending over our latest catalog featuring [产品类别].

[简短价值主张 - 1-2句话]

Would love to continue our conversation. Would you be available for a quick call next week to discuss your requirements in more detail?

Looking forward to hearing from you!

Best regards,
[Your Name]
[Your Title]
[Company]
[WhatsApp/WeChat]
```

### 模板2：展会后跟进
```
Subject: Following up from Canton Fair - [Product] solutions for [Country] market

Hi [Name],

It was great connecting with you at Canton Fair [届数]! I hope your time in Guangzhou has been productive.

As discussed, I'd like to share some information about our [产品类别] that I believe would be a great fit for [目标市场] market.

[核心卖点 - 1-2句话]
[具体数据或案例]

I've attached our latest price list and product brochure for your reference. Would you like me to arrange samples for your evaluation?

Best regards,
[Your Name]
```

---

## 二、主动开发信

### 模板1：海关数据客户开发
```
Subject: [竞品替代] Can we help [Company] reduce [成本/风险]?

Hi [Name],

I noticed [Company] has been importing [产品类别] from [竞品名称], with annual import volume around [金额].

We've been helping similar companies in [国家] achieve:
- [具体好处1，如：15-20% cost reduction]
- [具体好处2，如：Faster delivery]
- [具体好处3，如：Better quality control]

Would you be open to a brief call to discuss how we might create similar value for [Company]?

Best regards,
[Your Name]
```

### 模板2：新品推荐信
```
Subject: New [产品] for [目标市场] - Worth a look?

Hi [Name],

I wanted to reach out because we've just launched [新产品/系列] that I think could be relevant for [Company]'s portfolio.

Key highlights:
- [亮点1]
- [亮点2]
- [亮点3]

We're currently offering [特别优惠/条件] for initial orders.

Would you like more details?

Best regards,
[Your Name]
```

---

## 三、报价跟进信

### 模板1：报价后跟进
```
Subject: Re: Quotation for [产品] - Any questions?

Hi [Name],

I wanted to follow up on the quotation I sent last [时间] for [产品].

Have you had a chance to review the pricing? I'd be happy to:
- Clarify any specifications
- Discuss volume discounts
- Adjust terms if needed

Looking forward to your feedback!

Best regards,
[Your Name]
```

### 模板2：样品寄送后跟进
```
Subject: Samples shipped - Tracking & next steps

Hi [Name],

Great news! The samples you requested have been shipped today.

Tracking number: [运单号]
Estimated delivery: [日期]

Once you receive them, I'd love to schedule a call to discuss:
- Your feedback on quality
- Any adjustments needed
- Next steps for a trial order

Please let me know when the samples arrive!

Best regards,
[Your Name]
```


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)