Hlzd buyer finder

Skill Alexxiang2008/hlzd-b2b-export-skills/skills/hlzd-buyer-finder

Agent Skills for B2B industrial exporters — market research (HS code, UN Comtrade, Google Trends, tender), buyer finding (Alibaba + Volza customs), inquiry qualification, voice-contract HTML reports. By HLZD (海联智达).

Install

npx -y skills add Alexxiang2008/hlzd-b2b-export-skills --skill hlzd-buyer-finder

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

22 days oldThe repository was created 22 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

B2B 工业品海外采购商挖掘 —— 基于 Alibaba 国际站 + Volza 海关数据 + ImportGenius 公开目录，三链路自动发现真实海外买家，输出结构化 buyer JSON 与 Markdown 报告。Use when 用户说'找买家'、'找海外采购商'、'挖进口商'、'找客户'、'Volza 找买家'、'海关数据'、'find overseas buyers'、'find importers'、'B2B lead generation'。

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

10.5 KB, ~2.9k tokens by cl100k_base, as published. Nobody here has run it

HLZD 买家发现（Buyer Finder）

阿里 + Volza + 公开目录三链路找真实海外进口商。不编造买家名 —— 仅返回实际抓到或明确 mock 的数据；所有数据源失败时输出 warnings[]，绝不静默骗你。

When to use

调用本 Skill 当用户：

想把某个工业品卖到 X 国，要找该国的真实进口商
已知某个 中国竞对（如"厦门欣鸿金属"），想找他的海外买家清单
拿到 100+ 公司名列表，想 dedup / 评分 / 按 value 排序
想知道某个国家 / 关键词下的进口商规模与活跃度
跑 Volza / 阿里自动化，但担心被反爬 / 限额

不要调用本 Skill 当：

用户要找 中国卖家（你是中国卖家视角，请改用 hlzd-buyer-finder 的反向场景 = 暂时没做）
用户只是要单条买家信息查证 —— 用 hlzd-inquiry-qualify 反向灌入买家联系方式
用户要发邮件 / WhatsApp —— 应改用 hlzd-cold-outreach

How this skill is invoked

/hlzd-buyer-finder <product> <target-country>

完整调用

# 链路 A (默认): 阿里发现竞对 → Volza 找买家
py scripts/cli.py --product "OCTG casing" --country US

# 链路 B: 用户指定竞对 → Volza 直接搜
py scripts/cli.py \
    --competitor "Xiamen Hym Metal Products Co., Ltd." \
    --competitor "Shenzhen Kaier Wo Prototyping Technology Co., Ltd." \
    --country US \
    --method competitor

# 链路 C: 关键词 + 国家直接搜（跳过竞对）
py scripts/cli.py --product "container house mining" \
                   --country AU \
                   --method keyword

# JSON 输出 + 输出到文件
py scripts/cli.py --product "OCTG" --country US \
                   --output-json buyers.json --pretty

The 3-link pipeline

                  ┌─────────────────────────────┐
                  │     用户输入：产品 + 国家    │
                  └──────────────┬──────────────┘
                                 ↓
                ┌────────────────┴────────────────┐
                │   --method                       │
                ▼                  ▼               ▼
        ┌──────────────┐  ┌────────────────┐  ┌──────────────┐
        │ 链路 A: auto  │  │ 链路 B:        │  │ 链路 C:      │
        │               │  │ competitor     │  │ keyword      │
        │ 1. 阿里搜竞对  │  │                │  │              │
        │ 2. Volza找买家│  │ 用户提供竞对名 │  │ 关键词+国家   │
        └──────┬────────┘  └────────┬───────┘  └──────┬───────┘
               └──────────┬────────┴─────────┬───────┘
                          ↓                  ↓
                  ┌─────────────────────────────────┐
                  │  dedup_importers()              │
                  │  - normalize company name        │
                  │  - 取 max value 保留版本         │
                  │  - 按 USD 价值降序              │
                  └────────────────┬────────────────┘
                                   ↓
                    ┌──────────────────────────┐
                    │ JSON (schema hlzd/.../v1) │
                    │ + Markdown 报告            │
                    │ + warnings[] (缺失依赖说明) │
                    └──────────────────────────┘

链路 A：auto（默认）

适用：不知道竞对 + 想要广撒网

py scripts/cli.py --product "CNC machining" --country US

步骤：

Alibaba 搜竞对（https://www.alibaba.com/trade/search）：抽取中国供应商公司名，最多 5 家
每个供应商 → Volza 搜买家（https://www.volza.com/search?q=...）：取该供应商的历史进口商清单
全局 dedup → 按 USD 价值排序

限额：

Alibaba：每天 5 次搜索
Volza：每天 10 次搜索（免费版）

fallback：阿里被 captcha → 自动 seed 一个"Product Co., Ltd." → 继续 Volza，避免管线中断。

链路 B：competitor

适用：已知竞对 + 想跟单他们的客户

py scripts/cli.py \
    --competitor "Xiamen Hym Metal Products Co., Ltd." \
    --competitor "Shenzhen Kaier Wo Prototyping Technology Co., Ltd." \
    --country US \
    --method competitor

跳过阿里，竞对名直接来自 CLI 输入。

链路 C：keyword

适用：无竞对信息、关键词范围搜索

py scripts/cli.py --product "container house mining" \
                   --country AU \
                   --method keyword

直接按国家 + 关键词搜进口商，不依赖竞对名。

Output schema

{
  "$schema": "hlzd/buyer-finder/v1",
  "product": "OCTG casing",
  "country": "US",
  "method": "auto",
  "competitors": [
    { "company_name": "Xiamen Hym Metal Products Co., Ltd.", "source": "alibaba.com" }
  ],
  "importers": [
    {
      "importer_name": "ABC Machinery Inc",
      "country": "United States",
      "origin_country": "China",
      "quantity": "500 units",
      "value": "$125,000",
      "date": "2025-03",
      "source": "volza.com",
      "matched_competitor": "Xiamen Hym Metal Products Co., Ltd."
    }
  ],
  "warnings": [
    "volza_blocked (free-tier limit; upgrade Volza Pro or use ImportGenius / 52WMB)"
  ],
  "stats": {
    "competitors_found": 5,
    "importers_found_pre_dedup": 23,
    "importers_after_dedup": 12,
    "volza_quota_used": 5,
    "alibaba_quota_used": 1
  }
}

JSON 输出到 buyers.json，warnings 详细列出每个失败来源与备选。

Rate limiter & 反爬护栏

lib.RateLimiter 自动强制：

数据源	最小间隔	每日配额	状态保留
Alibaba	10s	5 次	`~/.cache/hlzd-buyer-finder/rate_state.json`
Volza	5s	10 次	同上

Volza blocked detection（lib.classify_volza_response）：

返回 body 长度	判定	处置
11055 ± 200 bytes	`blocked`	warning + skip，提示升级 Pro / 用 ImportGenius
≥ 15000	`success`	抽取表格
中间区间	`loading`	重试

为什么这是 deterministic：Volza 屏蔽固定返回首页，长度 11055 是经验值。无需网络即可单测。

Anti-scraping notes（来自 customs-data-find SOP）

风险	处置
Alibaba captcha	立即返回 warning；推荐手动登录或换 Volza
Volza free-tier 屏蔽	检测 11055 长度 → 提示升级 Pro
阿里反爬（cookie / JS）	推荐 Playwright；本 v0.1 仅做纯 HTML 抓取
ImportGenius / 52WMB	接口占位见 `sources/keyword.py`，二期接入
日配额已用完	state 文件持久化配额，跨 CLI 调用共享

Sample outputs

见 assets/sample-outputs/（占位，可附真实脱敏案例）。

Related Skills

        ┌─────────────────────────┐
        │  hlzd-b2b-research       │  ← 上游：先调研（HS、市场规模）
        │  4步 pipeline 出报告       │
        └────────────┬────────────┘
                     │ 衔接：国家 / 关键词
                     ▼
        ┌─────────────────────────┐
        │ ★ hlzd-buyer-finder ★  │  ← 本 Skill：找买家
        │ 3 链路 找真实采购商      │
        └────────────┬────────────┘
                     │
        ┌────────────┼────────────┐
        ▼            ▼            ▼
   customer         cold-        (next) query enrichment
   due-diligence    outreach     via LinkedIn / email
   (验证买家真实性)   (发邮件)

前置：hlzd-b2b-research 提供国家 / 产品 / HS context 后继：hlzd-customer-due-diligence（验证买家真实性）/ hlzd-cold-outreach（发开发信）

Boundaries & Limitations

本 Skill 不是买家真实性认证：Volza 数据可能滞后 / 来源仅反映历史，需配合 hlzd-customer-due-diligence 验证（域名 / 公司注册 / LinkedIn）。
本 Skill 不发邮件：仅给买家名单，触达请用 hlzd-cold-outreach。
本 Skill 不抓 LinkedIn：占位二期扩展。
Volza 免费版限制：每天 10 次搜索；详细联系方式需付费。要解更多字段请升级 Pro 或切 ImportGenius / 52WMB（接口已声明，待接入）。
Alibaba 反爬：纯 HTML 抓取可能被 captcha；如失败推荐切到 Playwright 版本（v0.2 计划）。
数据集滞后：Volza 数据延迟约 1 个月；新买家可能未及时反映。

Versioning

版本	说明
0.1.0	首版：3 链路 + urllib 实现 + 离线可单测 + 跨 CLI 配额持久化

升级轨迹见仓库根 VERSIONS.md。

Crafted for B2B industrial exporters — HLZD Cross-Border AI Platform · 2026