脱水蒜洋葱外贸寻客系统

要解决的问题

出口脱水蔬菜（蒜、洋葱）的外贸团队找海外买家，通常卡在三处：海关、展会、B2B 平台、商会名录分散在不同的站点，手动拼表格极慢；好不容易找到的公司名，真假难辨，贸然发开发信容易砸品牌；线索散落在 Excel、邮件和聊天记录里，换个人接手就断档，后续跟进也没有统一看板。

技能如何工作

该技能把寻客拆成一条可执行流水线，核心是每条线索必须可反查。

• 无 VPN 的三层通路：优先走境内直连源（海关总署、商务部、中信保、Alibaba 国际站、展会名录等）；其次调用官方开放 API（UN Comtrade、EU Eurostat/TARIC、US Census Bureau、OpenCorporates、VIES 等）；国内无法直连的源，不提供绕过工具，而是由用户自备合规跨境专线或商业数据服务商 API，技能只提供 proxy.json 与 L3 凭证的读取接口。运行前先执行 net_probe.py 生成当前可用源清单，不可用源自动降级并在 run_report.json 中标记 source_degraded。
• 采集与解析分离：collector.py 内置采集框架、解析器和限速/UA 池，但实际取数依赖主 Agent 在运行时调用 web_search / web_fetch，或用户已配置的商业 API。对无法直连的源，脚本输出 query_manifest.json，由 Agent 逐条取数后回填，再用 enrich.py 合并并按域名、公司名规范化、邮箱域三重键去重，跨国家合并同一实体。
• 背调与评分：due_diligence.py 按 7 个维度加权给出 0-100 分，并输出「已验证 / 待验证 / 高风险 / 已失效」标签。信用维度 D4 在免费渠道下默认返回基础分并明确标注 需人工补数据；接入中信保或邓白氏付费 API 后，可把 rating / score / report_id 回填到 credit 字段，脚本只做字段适配，不内置任何付费凭证。
• 入库与开发信：线索写入向量知识库时强制携带 source_url、collected_at、trace_path、expires_at，超过 staleness_days 自动置为 stale=true。匹配阶段按产品线（脱水蒜粒、蒜粉、洋葱粒、灭菌蒜粒）与目标市场计算匹配度，开发信支持 --lang auto|en|es|pt|ar，中东买家自动强调 Halal 认证并采用尊重式问候。
• 跟进与复跑：pipeline_board.py 维护阶段看板，支持「洽谈中」「已发样品」「未来 7 天待跟进」等状态；exporter.py 导出 Excel 线索表与 Word 背调报告。scheduler.py 生成的是调度描述，真正执行靠 refresh 子命令重跑「探测 → 采集 → 背调 → 匹配 → 入库 → 同步看板 → 导出」，并保留人工跟进状态。

适用边界

只面向脱水蒜/洋葱制品出口企业，产品线可在 assets/company_profile.json 中修改。不适用于希望零干预全自动的团队：部分源需要 Agent 联网取数，信用维度需要人工或付费 API 补数据。采集遵守 robots.txt 与平台 ToS，只取公开的企业级商务联系方式；遇到报错先查 references/faq.md。