用途:该技能用于对接 Apollo.io,补全联系人和公司信息,服务于潜在客户开发与销售情报。当用户需要查询联系人详情或进行公司调研时使用。
主要能力:提供 searchPeople(params) 按条件搜索人员、enrichPerson(email) 按邮箱补全联系人、searchOrganizations(query, params?) 搜索公司、enrichOrganization(domain) 按域名补全公司。API 路由为 GET /api/apollo/search,用于搜索联系人或公司。
使用方式:基础地址为 https://api.apollo.io,认证使用请求头 x-api-key: $APOLLO_API_KEY,环境变量为 APOLLO_API_KEY。内置 10 分钟内存缓存,最多 120 条。脚本用法示例:pnpm action apollo-search --email=user@example.com;pnpm action apollo-search --company=Example Inc;pnpm action apollo-search --domain=example.com;pnpm action apollo-search --company=Example Inc --title=CTO;pnpm action apollo-search --name="John Smith"。
限制与注意:enrichPerson 和 enrichOrganization 会吞掉错误并在失败时返回 null(try/catch)。所有搜索和补全均使用 POST,POST 响应缓存 10 分钟。涉及的 API 端点包括 /v1/mixed_people/search、/v1/people/match、/v1/mixed_companies/search、/v1/organizations/enrich。分页信息可通过 response.pagination?.total_entries 获取。