DIGGERKIT · 挖客工具

⛏️ 挖客工具 · 工厂自己跑

Python SDK + MCP server · Token 客户自购 · 数据客户自抓

跳到是什么 🤖 部署到我的网站
⛏️

DiggerKit 是什么

蒸馏的第 3 件产物 · 4 件永久免费
▼
跑在你自己服务器上的挖客工具。搜买家、评分、写开发信、生成报告 — 全部在你自己的机器执行, 结果写进你自己的数据库。 我们不持有任何买家数据。
2
种接入方式
¥0
永久免费
0
抽佣
0
数据留存
🔐 数据主权三原则
  • Token 客户自购 — 你自己买 LLM Token, 不经过我们
  • 数据客户自抓 — 抓到的买家信息存你自己服务器
  • 0 留存 0 抽佣 — 我们不存不卖不给第三方
🔑

Python SDK

5 行接入 · pip install
▼
1

安装

pip install 'git+https://github.com/SassumiX/diggerkit.git'

2

拿 API Key

Dashboard → API 配额 → 复制 gds_xxx

3

跑第一搜

search_leads() 直接返回 lead 列表

# ① 安装 pip install 'git+https://github.com/SassumiX/diggerkit.git' # ② 5 行接入 from diggerkit import DiggerKitClient c = DiggerKitClient(api_key="gds_xxx") leads = c.search_leads( query="100% cotton poplin 133x72 GOTS", country="DE", limit=5 ) for x in leads: print(x["company"], x["country"], x["gd_score"])
📋 全部方法
search_leadsmulti_query_loop minelist_leads check_quotahealth
# mine_leads (C / C+ tier) leads = c.mine( query="organic cotton fabric GOTS", country="Germany", limit=5, tier="C+" # tier: C = base / C+ = enhanced ) # list_leads (saved in YOUR own database) saved = c.list_leads()
⚡

DiggerKit-C+ · MCP server

工厂 Agent 1 击接入 · Claude / Cursor / VSCode
▼
让工厂的 AI Agent (Claude Code / Cursor / VSCode Copilot) 直接调用挖客能力。 配一次 JSON, 之后在 IDE 里用自然语言就能挖客。
# Claude Desktop / Cursor / VSCode 通用配置 { "mcpServers": { "golddigger": { "command": "node", "args": ["/absolute/path/to/diggerkit/mcp/node/index.js"], "env": { "GOLDDIGGER_API_KEY": "gds_xxx" } } } }
💬 在 IDE 里怎么用
# 在 Claude Code / Cursor 里直接说 "帮我找 20 家德国的家居面料采购商, 要 OEKO-TEX 100, 客单价 5 万欧以上" # Agent 自动调用 search_leads, 跑完给你表格 "给前 5 家各写一封德语开发信, 提到我们的 GOTS 认证和 TrustScore 73" # The Agent calls search_leads, then writes the outreach email with your own LLM token
  • Claude Code / Claude Desktop
  • Cursor
  • VSCode (Copilot / Continue / Roo)
  • 任何支持 MCP 协议的 IDE
📥

下载

SDK / MCP / Skill 文档 · 真实可跑文件
▼
📦
DiggerKit SDK v2.2.0 (zip)
Python SDK + MCP server + 你的关键词 · 零第三方依赖
26.8 KB ↓
⚡
DiggerKit MCP server v2.2.0 (zip)
MCP server · mcp.json 配置 + package.json (Node 18+)
11.8 KB ↓
📥 或用包管理器
# ① SDK (Python 3.9+) pip install 'git+https://github.com/SassumiX/diggerkit.git' # ② MCP (Node 18+) git clone https://github.com/SassumiX/diggerkit.git && node diggerkit/mcp/node/index.js # ③ 不想装包?直接用官方 zip(国内最稳) curl -LO https://golddigger.gold/static/diggerkit-v2.2.0.zip unzip diggerkit-v2.2.0.zip
📊

4 档配额

Starter 永久免费 · 不绑卡
▼
Starter ¥0
20 次 / 天 · 4 件工具全免费 · 不绑卡
Pro ¥199/月
100 次 / 天 · 带画像雷达图报告
Premium ¥1,999/月
500 次 / 天 · 多平台分发 · 团队协作
Whitelabel ¥5,999/月
无限 · 白标 · 商会/平台联名签发
🧾 查你的配额
# SDK 里查 c = DiggerKitClient(api_key="gds_xxx") print(c.check_quota()) # → {'tier': 'starter', 'used': 8, 'limit': 20, 'reset_at': '...'} # 或看 Dashboard dashboard.html → API 配额折叠层
🚀

怎么用 · 3 步

拿 Key → 装 SDK → 跑第一搜
▼
1

拿 API Key

Dashboard → API 配额 → 复制 gds_xxx

2

装 + 配

源码装 DiggerKit, 或写 MCP JSON 配置

3

跑第一搜

search_leads() 20 个 lead, 数据落你自己库

🤖 把机器人部署到你自己蒸馏后的网站三种路线 · 可复制代码 · 30 分钟上线 · 0 抽佣 看指南 →
▶️
完整操作流程 (复制就能跑)
收起
▶
# ═══ 终端 1: 起你的数据目录 (买家信息只存这里) ═══ mkdir -p ~/golddigger-leads export GOLDDIGGER_API_KEY="gds_YOUR_KEY" # ═══ 终端 2: 装 SDK ═══ pip install 'git+https://github.com/SassumiX/diggerkit.git' # ═══ 终端 3: 写第一个脚本 ═══ cat > first_search.py << 'PY' from diggerkit import DiggerKitClient import json, datetime c = DiggerKitClient() # reads GOLDDIGGER_API_KEY automatically # ① 查配额 (Starter 20 次/天) print("配额:", c.check_quota()) # ② 搜买家 — 用你的产品 + 认证 + 目标市场 leads = c.search_leads( query="全棉府绸 133×72", country="color:#86EFAC", limit=5 ) # ③ 存成你自己的文件 (我们不碰) fn = f"~/golddigger-leads/leads_{datetime.date.today()}.json" with open(fn, "w", encoding="utf-8") as f: json.dump(leads, f, ensure_ascii=False, indent=2) print(f"存了 {len(leads)} 个 lead → {fn}") for x in leads[:5]: print(f" {x['company']} · {x['country']} · score {x['score']}") PY python3 first_search.py # ═══ 接下来: 让工厂 Agent 接管 (可选) ═══ # Claude Code / Cursor 里直接说: # "给前 5 家各写一封德语开发信, 提到 GOTS 认证和 TrustScore 73"
产出: ~/golddigger-leads/leads_YYYY-MM-DD.json — 只在你自己的机器上, 我们不持有
⚠️
常见问题排查
展开
▶
ValueError: 需要 API Key
→ 环境变量 GOLDDIGGER_API_KEY 没设, 或 key 拼错了 (应该是 gds_ 开头)
HTTP 429: quota exceeded
→ 今日 20 次用完了, 明天 0 点重置, 或升 Pro (¥199 → 100 次/天)
HTTP 403: CountryBlocked
→ 目标国家不在开放范围, 换个市场试
搜出来 0 个 lead
→ 认证条件太严 (比如同时要 GOTS + ZDHC + OEKO-TEX + Blue Angel)。先放宽到 1-2 个
超时 / 连接失败
→ 检查 GD_BASE_URL 是否正确, 默认 https://golddigger.gold/textile
📊 去 Dashboard 拿 Key 📖 操作指南 🤖 机器人部署指南
🏠
首页home.html
🧪
蒸馏register.html
📊
看板dashboard.html
🎨
墨库ink-library.html
🔗
供应链supplier.html