git clone https://github.com/SassumiX/golddigger-mcp.git
cd golddigger-mcp
pip install -r requirements.txt

# Set your Golddigger API key (customer provides their own)
export GOLDDIGGER_API_KEY="gd_your_key_here"
export GOLDDIGGER_HOST="https://golddigger.gold"   # 可选
export GOLDDIGGER_DAILY_BUDGET=20     # 可选：本地软预算，默认 20
export GOLDDIGGER_QUOTA_RESERVE=2     # 可选：剩余低于此值不再自动搜

{
  "mcpServers": {
    "golddigger": {
      "command": "python3",
      "args": ["/FULL/PATH/TO/golddigger-mcp/server.py", "--transport", "stdio"]
    }
  }
}

{
  "mcpServers": {
    "golddigger": {
      "command": "python3",
      "args": ["/FULL/PATH/TO/golddigger-mcp/server.py", "--transport", "stdio"],
      "env": {
        "GOLDDIGGER_API_KEY": "gd_your_key_here"
      }
    }
  }
}

python3 server.py --transport streamable-http --port 8080

用户说："出客户画像报告"
Agent 自动调用 → 生成本地 .docx 文件

# Agent 调用示例
result = golddigger.generate_report(
    company_name="cnpulk.com",
    product_desc="DTH drill bits, rock drilling tools",
    buyers=[
        {
            "name": "Afrimat Limited",
            "country": "南非",
            "industry": "Mining",
            "has_contact": True,
            "scale": "上市矿业集团",
            "buyer_role": "Contract Mining总监",
            "purchase_needs": "DTH钻头，持续消耗",
            "contacts": ["pierre@afrimat.co.za · +27 82 411 7475"],
            "outreach": "We offer 20-30% cost savings on DTH bits."
        },
        # ... 2 more buyers
    ],
    api_key="gd_customer_own_key"   # 客户自己的Key，费用自担
)
# result["output_path"] → 本地 .docx 文件路径

result = golddigger.score_lead(
    company="Afrimat Limited",
    country="南非",
    industry="Mining",
    has_contact=True,
    scale="上市矿业集团",
    note="并购整合期"
)
# result["total"] = 91, result["tier"] = "HOT"

check_quota → search_leads(dry_run) → search_leads → 对每条 lead 跑 draft_outreach → 进 outreach_queue.csv → 按 D0/D3/D7/D14 跟进

r = golddigger.draft_outreach(
    lead={"company": "Bin Harkil Group", "contact": "Procurement",
          "country": "SA", "industry": "real estate developer"},
    my_profile="smart lock factory, OEM/ODM, CE, MOQ 200, 7-day samples",
    channel="email", language="en",
)
# r["subject"], r["body"], r["followup_plan"], r["quota_cost"] == 0