Target Contact Finder — 目标联系人查找器
v1.0.0CRM 客户画像搜索与批量导入技能。只要用户提到以下任意一项就必须使用此技能：找客户、搜客户、搜索客户、客户画像、潜在客户、目标客户、客户列表、录入CRM、导入客户、批量导入、添加客户、找一批xx客户、xx地区的客户、xx行业的客户、酒店客户、酒旅客户、OTA客户、旅行社客户、商旅客户、分销客户、批发客户、TMC、DMC、bedbank、wholesaler、B2B客户。即使用户没有明确说"CRM"或"画像"，只要意图是寻找、筛选、导入潜在客户，都要立即使用此技能。
by 运行时依赖
安装命令
点击复制技能文档
CRM 客户画像搜索与批量导入 通过结构化条件搜索酒旅行业与 B2B 场景的潜在客户，确认后批量导入 CRM。 API Base URL: http://39.108.114.224:9059 所有接口的请求体中均需包含 user_key 字段。
接口列表 功能 Method Path 搜索客户画像 POST /skill/search_customer_profile 批量导入客户 POST /skill/batch_import_customer
调用方式 # 搜索客户画像 curl -s -X POST -H "Content-Type: application/json" \ "http://39.108.114.224:9059/skill/search_customer_profile" \ -d '{ "user_key": "", "q_keywords": "hotel hospitality resort", "organization_locations": ["Japan"], "person_titles": ["Business Development", "Partnership Manager"], "person_seniorities": ["manager", "director", "head"], "contact_email_status": ["verified", "likely to engage"], "per_page": 10, "page": 1 }'
# 批量导入客户 curl -s -X POST -H "Content-Type: application/json" \ "http://39.108.114.224:9059/skill/batch_import_customer" \ -d '{ "user_key": "", "customers": [ { "name": "Hilton Tokyo", "contact_name": "John Smith", "contact_email": "john@hiltontokyo.com", "contact_phone": "80012345", "contact_phone_prefix": "+81", "country_code": "JP", "address": "Tokyo, Japan", "remark": "Business Development | Hospitality" } ] }'
响应格式 成功响应： { "ok": true, "data": { ... } } 失败响应： { "ok": false, "error": "错误描述" }
search_customer_profile 成功时 data 字段： { "total_entries": 120, "credits_consumed": 5, "customers": [ { "name": "公司名", "contact_name": "联系人", "contact_email": "email@example.com", "contact_phone": "12345678", "contact_phone_prefix": "+81", "country_code": "JP", "address": "Tokyo, Japan", "remark": "Title | Industry" } ] }
batch_import_customer 成功时 data 字段： { "success_count": 8, "fail_count": 2, "fail_details": [ {"name": "公司名", "email": "xxx@example.com", "reason": "联系邮箱已存在"} ] }
核心流程
- 用户描述目标客户
- 你将自然语言拆解为 Apollo 可识别的结构化参数
- 调用 /skill/search_customer_profile
- 展示结果并询问是否导入
- 用户确认后调用 /skill/batch_import_customer
业务背景（重要） 本公司是 酒旅行业 B2B 服务商，核心目标客户主要包括： 酒店：hotel, resort, hospitality group, serviced apartment 旅游：travel, tourism, tour operator, travel agency OTA / 分销：OTA, online travel agency, wholesaler, bedbank, distribution 商旅：business travel, corporate travel, TMC 地接 / 目的地服务：DMC, destination management 目标联系人优先是： 商务合作负责人：Business Development, Partnership, Commercial 采购 / 签约负责人：Procurement, Contracting, Sourcing, Supplier 酒店收益 / 渠道负责人：Revenue, Distribution, Ecommerce 高层决策人：Founder, Owner, CEO, GM, VP, Head, Director
Setup 调用任何接口前，必须先完成用户身份验证。 Step 1 - User Key 读取 {baseDir}/user_key.txt 如果文件不存在或为空，不要调用任何接口，告知用户： "在开始之前，需要先验证你的身份。请前往 https://aauth-170125614655.asia-northeast1.run.app/dashboard 用 Google 账号登录，复制你的 user_key（格式：uk_xxxxxxxx），然后告诉我。" 如果文件存在且有内容，将其值作为所有请求体中的 user_key 如果任意接口返回 HTTP 401 或响应体 {"ok": false, "error": "unauthorized: ..."} ，删除 {baseDir}/user_key.txt 并重新执行第 2 步
接口参数说明 /skill/search_customer_profile 参数 类别 类型 说明 user_key string 从 {baseDir}/user_key.txt 读取 q_keywords string 英文关键词，多个词用空格分隔 person_titles string[] 联系人岗位 person_locations string[] 联系人所在地区 organization_locations string[] 公司所在地区，优先使用 person_seniorities string[] 联系人层级 contact_email_status string[] 邮箱状态 organization_num_employees_ranges string[] 公司人数范围 revenue_range_min int 最低营收（美元） revenue_range_max int 最高营收（美元） per_page int 每页数量 page int 页码，从 1 开始
/skill/batch_import_customer 参数 类别 类型 说明 user_key string 从 {baseDir}/user_key.txt 读取 customers CustomerItem[] 要导入的客户列表 CustomerItem 字段： 字段 类型 说明 name string 客户或公司名称（必填） contact_name string 联系人姓名（必填） contact_email string 联系人邮箱（必填） contact_phone string 联系人电话（必填） contact_phone_prefix string 电话区号，如 +81 country_code string 国家编码，如 JP address string 地址 remark string 备注或画像描述
Apollo 搜索原则（非常重要） Apollo 这一套接口本质是 按人搜索，不是按一句画像描述直接找公司。 正确思路是： 先定义 公司画像 再定义 联系人画像 最后再补邮箱状态、规模、营收等过滤条件 也就是说，你在构造参数时要优先关注： q_keywords：行业和业务模式关键词 organization_locations：公司所在区域 person_titles：联系人岗位 person_seniorities：联系人层级 不要把用户原话整句塞给 Apollo。 特别是 q_keywords： 必须转成英文关键词 要短、准、可检索 不要传中文 不要传长句 不要只写一个空泛词如 B2B
参数解析指南（必须遵守）
- 先判断搜索意图属于哪一类
- q_keywords 规则
- 地区规则