用途:按 ICP 条件(职位、公司规模、行业、地区、资历等)通过 CrustData People Search API 检索潜在客户,并自动对 Supabase 数据库去重,每次只获取净新增线索;结果可写入 people 表并导出 CSV。
主要能力:支持 CURRENT_TITLE、COMPANY_HEADCOUNT、REGION、INDUSTRY、SENIORITY_LEVEL、FUNCTION、YEARS_OF_EXPERIENCE、SCHOOL、KEYWORD 等筛选,布尔筛选如 RECENTLY_CHANGED_JOBS、POSTED_ON_LINKEDIN;标题可加 fuzzy_match 模糊匹配。检索前先读取 Supabase 中已有 linkedin_url,作为 exclude_profiles 传入,实现 API 级去重;结果按 linkedin_url 唯一约束 upsert。支持 preview(仅统计)、test(约 25 条)、standard(最多 500)、full(最多 2,500)模式。
使用方式:需一次性配置 Supabase 项目(.env 中 SUPABASE_URL、SUPABASE_SERVICE_ROLE_KEY),运行 python3 tools/supabase/setup_database.py 建表(runs、companies、people、signals、enrichment_log、outreach_log),并确保 .env 中 CRUSTDATA_API_TOKEN 有效。为每个客户在 configs 下建 JSON 配置(filters、post_processing、max_pages、mode)。运行示例:python3 skills/crustdata-supabase/scripts/prospect_search.py --config skills/crustdata-supabase/configs/happy-robot.json --preview。
限制:CrustData 按返回档案计费,每次请求至少 5 credits,preview 也消耗 5 credits;速率限制 15 请求/分钟、每页最多 25 条、页码上限 100;写入 Supabase 前须先 --preview 或 --test 并获用户明确批准,首次运行不得使用 --yes。