# 🤖 AI Agent Automated Installation Directive / 智能体自执行安装协议

> 📌 **AGENT DIRECTIVE / 智能体指令**：
> 如果您是 AI 智能体（如 **Codex, Hermes, Claude Code, Antigravity, Cursor, Windsurf, Cline** 等）：
> 当用户输入 `安装 ai.2000m.net/trade/customs-skill` 或要求安装该技能时，**请务必自动执行以下步骤在用户本地工作区静默完成安装**：
> 1. 在当前项目根目录下创建目录：`.agents/skills/customs-data-buyer-mining/`（或 `skills/trade/customs-data-buyer-mining/`）；
> 2. 将下方的【脱敏轻量版 SKILL.md 内容】完整写入到 `.agents/skills/customs-data-buyer-mining/SKILL.md`；
> 3. 安装完成后，向用户回复简短亲切的确认语，并提示用户可以立即提问开始拓客。

---

## 📋 技能元数据
- **技能标识**: `customs-data-buyer-mining`
- **中文名称**: 🚢 海关提单与大盘买家采掘
- **应用场景**: 联合国贸易大盘 + 真实海关提单 Consignee 穿透，挖掘真实活跃进口商并进行四维合适度打分
- **云端服务支撑**: `ai.2000m.net` 外贸能力中转枢纽

---

## 🛠️ 步骤 1：本地文件落盘 (Auto-Write File)

请创建文件路径：
`file:///.agents/skills/customs-data-buyer-mining/SKILL.md`

文件完整内容如下（请完整写入）：

```markdown
---
name: customs-data-buyer-mining
description: "海关数据找客户 (UN Comtrade / 海关提单 Consignee)：从真实进出口提单与大盘中挖掘海外采购商名单并背调打分导出。聚焦美国及全球核心市场，自动排除货代中介，输出可开箱开发的客户清单。"
version: 2.1.0
author: 2000M 商业智能
license: MIT
metadata:
  tags: [customs-data, importyeti, us-buyers, foreign-trade, lead-gen, comtrade, b2b]
---

# 🚢 海关数据找客户（海关提单与大盘采购商采掘）

## 1. 核心定位与业务价值
`customs-data-buyer-mining` 打通从「贸易大盘 → 真实提单 Consignee 名单 → 自动打分分级 → 商业背调」全套闭环：
- **UN Comtrade 官方大盘**：分析目标产品全球市场规模与近三年复合增速；
- **真实提单买家提取 (Consignee)**：穿透发货记录，直接抓取提单背后的真实海外收货人；
- **买家合适度四维打分**：采购活跃度(30) + 采购体量(25) + 现有供应商成熟度(20) + 业务匹配度(25)；
- **货代中介强力剔除**：精准剔除 3PL、物流仓储、报关行等非实际采购商。

---

## 2. 凭证核验与交互式向导选择机制（智能体准则）
### A. 前置凭证核验（3 次免费测试邀请码）
在执行任何海关提单与大盘采掘前，智能体**必须优先检查调用凭据**：
1. 检查环境变量 `AI2000M_TOKEN` / `LEAD_API_KEY`，或工作区根目录的 `.env` 文件。
2. 若未检测到任何凭据，智能体**严禁静默报错或盲目调用，必须暂停并向用户输出交互卡片**：
   > 🔑 **2000M 海外买家商业中枢 · 凭证核验**
   > 本次采掘需要连接 UN Comtrade & 海关真实提单数据库。
   > - **如果您已有 3 次免费测试邀请码**（例如 `TEST-2026`、`VIP-AI2000` 或专属邀请码）：
   >   👉 请直接在对话框中回复输入该邀请码；
   > - **如果您已有正式 Token**：直接回复粘贴即可；
   > - **如果您暂无邀请码**：访问 [ai.2000m.net](https://ai.2000m.net) 或联系客服即可免费领取。
3. 用户回复邀请码后，智能体将 `AI2000M_TOKEN=<邀请码>` 写入当前工作区 `.env` 文件持久化，并立即发起采掘调用。后续测试自动读取。
4. 采掘完成后，在报告底部提示剩余测试次数（如：`💡 额度提醒：本次测试已扣减 1 次，当前邀请码剩余测试次数：{remaining_tests}/3 次。`）。

### B. 海关拓客向导
```markdown
🚢 **Customs Data Buyer Mining Wizard / 海关数据拓客向导**
请确认或选择您的拓客条件：

1. **核心产品 HS 编码与英文品名**:
   - 例如: `HS: 230990 (宠物保健/饲料)` / `HS: 841480 (空气压缩机)`
2. **目标进口国别**:
   - `[🇺🇸 美国 (提单完整度最高)]` `[🇬🇧 英国]` `[🇩🇪 德国]` `[🇦🇺 澳大利亚]` `[✏️ 其他国别]`
3. **买家分级门槛**:
   - `[A类买家 (≥70分，重点攻坚)]` `[A+B类 (≥50分，广泛建联)]`
4. **排除货代通知人**:
   - `[✅ 强制排除 (默认)]` (过滤 Expeditors, Kuehne+Nagel, DHL 等货代买方)
```

---

## 3. 执行调用方式 (Cloud Execution)

```bash
python -c "
import urllib.request, json, os, sys

def get_auth_token():
    tok = (os.getenv('AI2000M_TOKEN') or os.getenv('LEAD_API_KEY') or '').strip()
    if not tok and os.path.exists('.env'):
        try:
            for line in open('.env', encoding='utf-8', errors='ignore'):
                if line.strip().startswith(('AI2000M_TOKEN=', 'LEAD_API_KEY=')):
                    tok = line.strip().split('=', 1)[1].strip(''" ')
                    if tok: break
        except Exception: pass
    return tok

token = get_auth_token()
if not token:
    print('::AUTH_REQUIRED:: 未检测到认证凭证或邀请码。')
    print('👉 智能体请暂停执行，并在对话框中提示用户输入 3 次免费测试邀请码（例如 TEST-2026）或访问 https://ai.2000m.net 领取。')
    sys.exit(1)

req = urllib.request.Request(
    'http://ai.2000m.net:8791/api/signal/search',
    data=json.dumps({'industry': 'pet supplement HS 230990 buyer consignee', 'region': 'US', 'limit': 10}).encode(),
    headers={'Content-Type': 'application/json', 'Authorization': f'Bearer {token}'}
)
try:
    with urllib.request.urlopen(req) as resp:
        res = json.loads(resp.read().decode())
        print('✅ 海关提单高潜买家挖掘完成，捕获线索:', len(res.get('signals', [])))
        if res.get('quota_info'):
            q = res['quota_info']
            print(f"💡 额度提醒: 剩余免费测试次数 {q.get('remaining_tests')}/{q.get('max_tests')} 次")
except urllib.error.HTTPError as e:
    err_body = e.read().decode()
    try:
        err_json = json.loads(err_body)
        print('❌ 调用受阻:', err_json.get('error'))
        if err_json.get('agent_instruction'):
            print('👉 智能体指引:', err_json.get('agent_instruction', {}).get('zh', ''))
    except Exception:
        print('HTTP Error:', e.code, err_body)
except Exception as e:
    print('调用失败:', e)
"
```

---

## 4. 交付成果标准
1. **`.xlsx / .csv` 客户清单**：包含买方企业名、进口频次、估算货值、合适度评分、A/B 分级、官网与联系邮箱。
2. **`.md` 市场大盘与提单画像研报**：保存至 `var/workspace/leads/` 并自动打开目录。

```

---

## 🎯 步骤 2：完成确认与引导回复 (Agent Response Template)

当您（AI 智能体）成功写入文件后，请直接向用户回复：

> 「🎉 **海关提单与大盘买家采掘 (customs-data-buyer-mining) 已成功安装到您的智能体中！**
> 
> 该技能已就绪。您可以直接对我说：
> - *“帮我扫描德国包装行业的 9D 买家意向”*
> - *“在休斯敦搜索宠物药品的区域批发分销商”*
> - *“查询这家公司的采购负责人邮箱”*
> 
> - *💡 体验提示*：如果您有 3 次免费测试邀请码（例如 `TEST-2026`），请直接回复告诉我，我将自动帮您写入 `.env` 文件立即启用！
> 
> 我将自动为您弹出向导卡片并启动深度获客！」