Skip to main content
Glama
DiggerKit MCP Server

DiggerKit MCP Server

by SassumiX

DiggerKit

GoldDigger SI Agent 的金铲子 —— Python SDK + MCP server,让你的 AI Agent 一行接入挖客。

SI Agent = Supper Intelligence Agent = 你(外贸供应商)自己的 AI Agent(Claude / Cline / Cursor / 自家 worker)。 DiggerKit 助力赋能 = 我们给你工具,不替你跑。

服务端

https://golddigger.gold

商务合作

factorihub@outlook.com

备案号

浙ICP备2026078906号-1

许可证

MIT


安装

从源码(推荐,PyPI 未发布)

git clone https://github.com/SassumiX/diggerkit.git
cd diggerkit
pip install -e .

零第三方依赖 —— DiggerKitClient 只用 Python 标准库,pip install -e . 不会拖进任何包。

需要 v1.1 旧版 SDK(GolddiggerClient / AgentTokenClient)时:

pip install -e ".[legacy]"

国内网络不通 GitHub 时

用离线 bundle 走服务器侧更新通道(见下方「离线更新通道」),或直接取 releases/ 下的 zip。


Related MCP server: governed-mcp

30 秒接入

from diggerkit import Client

c = Client(api_key="gds_你的KEY")     # 供应商 gds_ / 买家 gdb_
print(c.quota())                      # 配额
leads = c.search_leads(keywords=["silk scarf"], lang="es")

也可以直接用命令行:

python -m diggerkit.client --api-key gds_你的KEY --query "silk scarf" --country AE

认证:API Key 走 X-API-KEY header,来源 https://golddigger.gold/ui/。 Agent 授权走 AgentTokenClient(agent_token="agt_...")。


MCP server(只读工具集)

diggerkit/mcp/ 是零依赖的 Node 实现(Node ≥ 18)。

cd diggerkit/mcp
node node/index.js --api-key gds_你的KEY

客户端配置(把路径换成你的绝对路径):

{
  "mcpServers": {
    "golddigger": {
      "command": "node",
      "args": ["/absolute/path/to/diggerkit/mcp/node/index.js"],
      "env": {
        "GOLDDIGGER_API_KEY": "gds_xxxxxxxx",
        "GOLDDIGGER_BASE_URL": "https://golddigger.gold"
      }
    }
  }
}

工具集只读 —— 不提供写入、不提供外发、不提供裸数据导出。 每个结果带 provenance(来源 + 置信度),不给没来处的结论。 check_readiness 一次报全所有阻塞项;check_answerable 覆盖不足就明说。

⚠️ npm 上的 golddigger-mcp 包从未发布(404)。请用本仓库的源码跑,别用 npx -y golddigger-mcp。


离线更新通道

本仓库支持用 git bundle 做离线同步(服务器到 GitHub 直连不稳、或内网环境):

# 首次
git clone git@github.com:SassumiX/diggerkit.git /opt/diggerkit

# 之后每次(拿到 diggerkit.bundle 后)
cd /opt/diggerkit
git pull /path/to/diggerkit.bundle main
git push origin main

git bundle 是单文件全量镜像,git pull <bundle> main 会把该 bundle 里的提交并进本地 main。


版本历史

版本

日期

内容

v2.1.0

2026-11-11

MCP server 重写:零依赖 Node、只读工具集、check_readiness / check_answerable

v2.0.0

2026-11-11

Python SDK 重写:纯标准库、错误分层(Quota / InvalidKey / RateLimited / ServerError)

v1.1.0

2026-10-09

Agent 授权机制(4 维度控制)+ diggerkit_tools.py 工具箱(服务端)

v1.0.0

2026-10-08

首个公开包

历史 zip 全档在 releases/。


边界

  • 我们不替你跑 Agent:Token、LLM、模型你自带。

  • API 池与挖客行动池是两套独立配额,各自 UTC 00:00 重置。

  • 蒸馏永久免费。

  • 我们不持有你的买家数据。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to query internal business data for insights into customers, revenue, subscriptions, sales, and churn through controlled, read-only MCP tools.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to query a read-only data surface through typed tools, enforcing caller-specific row access, field masking, and withheld-row disclosure so they can retrieve entitled information without writes or silent data leakage.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to safely query SQL databases through read-only tools for describing entities, reading records, and aggregating records, with view-based access and fail-closed per-user row-level security.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to answer seller questions from previously saved research using read-only tools for accounts, initiatives, intent signals, key people, knowledge retrieval, and guarded dataset queries. It supports multi-tenant, authenticated access with tenant isolation and enforced read-only security.
      MIT