PlaceCall
让你的智能体用语音拨打美国企业电话，完成预订、询价与信息核实，并拿回结果与通话记录。
- Star 数
- ★ 104
- 最近更新
- 2 天前
- License
- MIT
- 主语言
- Shell
- FA 评分
- 66/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配ChatGPT · Codex · Claude Code · Claude.aiOpenAI API · Claude API（部分支持）
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 餐厅订位：出差前让 Claude Code 依次拨打几家芝加哥餐厅，确认周六 8 点是否还有四人桌，并取回确认结果。
- 不适合
- 需要拨打美国以外号码（IN、LA、MN、MT、NE 除外）的用户
- 要求完全本地、不外呼真实电话的团队
- 需要自托管或自主控制通话基础设施的用户
- 源码审查
- 66/100 · 存在缺口
这个 Agent 能做什么，适合哪些场景？
PlaceCall 是一个托管的电话外呼服务，把真实的美国电话拨号能力接进 AI 智能体。它通过 POST https://api.voygr.tech/calls 接收目标号码和一段自然语言 brief，自动拨号、应对 IVR 与等待音乐，并与对方交谈。每次通话返回 17 种经过核实的 outcome_type 之一，外加完整转写和录音；通话过程中还能通过 POST /calls/{id}/answer 回应智能体中途提出的问题。接入方式包括 Claude Code、Codex、Cursor 插件（内置 skill 与 MCP 服务器）、claude.ai 与 ChatGPT 连接器、Gemini CLI 扩展、Hermes 以及任意 MCP 客户端，此外还有纯 HTTP 的 curl 路径和 Apify Actor。号码不确定时，POST /v1/places/suggest 可按自然语言描述推荐候选商家并解释理由。服务端在 voygr.tech 云端运行，用户侧只需要一个支持 HTTP 或 MCP 的智能体环境。
给定 US 电话号码和一段英文 brief，PlaceCall 拨号、导航 IVR 与等待、与商家对话，并产出 outcome_type、完整转写和录音。它在通话中可发起问题，等待智能体通过 POST /calls/{id}/answer 回答。跟踪接口包括 GET /calls/{id}、GET /calls/{id}/events、POST /calls/{id}/cancel 与 GET /calls/{id}/recording。没有号码时，POST /v1/places/suggest 接收自然语言请求（如“芝加哥周六晚上 8 点的浪漫餐厅”），返回候选商家、选择原因并代写 call brief。MCP 服务器 https://api.voygr.tech/mcp 暴露四个工具：suggest_places、place_call、get_call_result、answer_question。账户类接口包括 GET /users/me、GET /v1/usage、GET /checkout/packs、PUT /users/me/limits。所有请求通过 HTTPS 只发往 api.voygr.tech 一个主机。
- 餐厅订位：出差前让 Claude Code 依次拨打几家芝加哥餐厅，确认周六 8 点是否还有四人桌，并取回确认结果。
- 批量询价：小型装修业主把一份水电工名单交给 Apify Actor，让 PlaceCall 逐一询问上门报价与最早预约时间。
- 信息核实：电商运营让智能体打电话确认某家供应商的库存与发货周期，避免只看网页数据。
- 改约与取消：个人助理在 ChatGPT 中调用 PlaceCall，为已订的诊所预约改期，并把转写留存作为凭证。
- 场地筛选：手上没有具体号码时，先用 suggest_places 让 PlaceCall 推荐候选并解释选择理由，再逐个拨打。
- 语音代理开发：开发者用任意 MCP 客户端（Cursor、Windsurf、MCP Inspector）接入 /mcp，把外呼能力嵌进自己的智能体工作流。
如何安装或部署这个 Agent？
最简单的路径是 Claude Code 插件，自动从本仓库更新，不需要 shell 或 git：
/plugin marketplace add voygr-tech/placecall
/plugin install placecall@placecall安装后运行 /mcp，选择 placecall 服务器并用浏览器登录；首次登录会创建带免费额度的 PlaceCall 账户，无需复制密钥。Codex 使用同一插件：
codex plugin marketplace add voygr-tech/placecall
codex plugin add placecall@placecall
codex mcp login placecallclaude.ai 与 ChatGPT 通过自定义 MCP 连接器接入，URL 填 https://api.voygr.tech/mcp，认证方式选 OAuth。任意 MCP 客户端可手动添加：
claude mcp add --transport http --scope user placecall https://api.voygr.tech/mcp只安装 skill 而不带插件时（需要 API 密钥）：
git clone https://github.com/voygr-tech/placecall && cd placecall
./install.shGemini CLI 与 Hermes 也各有安装方式：
gemini extensions install https://github.com/voygr-tech/placecallhermes mcp add placecall --url https://api.voygr.tech/mcp/ --auth header如何使用这个 Agent？
先获取 API 密钥（skill-only 路径和原始 HTTP 调用必需）：打开 https://api.voygr.tech/checkout?src=gh-repo 点击 Get free API key，密钥通过邮件发送。然后导出：
export PLACECALL_API_KEY="<your key>"发起一次通话的最简调用如下，brief 里要写清问什么、给谁、日期、人数、回拨号码和期望结果，因为机器人只读 brief：
curl -s -X POST https://api.voygr.tech/calls \
-H "X-API-Key: $PLACECALL_API_KEY" -H "Content-Type: application/json" \
-H "X-Client-Surface: gh-repo" \
-H "X-Client-Agent: ${CLAUDECODE:+claude-code}${CURSOR_AGENT:+cursor}${CODEX_SANDBOX:+codex}${GEMINI_CLI:+gemini-cli}" \
-d '{"target_phone":"+1XXXXXXXXXX","brief":"Call this restaurant and ask what time the kitchen closes tonight.","language":"en"}'轮询通话结果，直到 outcome_type 非空、transcript_status 为 final：
curl -s -H "X-API-Key: $PLACECALL_API_KEY" https://api.voygr.tech/calls/{id}检查密钥与额度：
curl -s -H "X-API-Key: $PLACECALL_API_KEY" https://api.voygr.tech/users/me注意：只拨打你有权拨打的号码；目的地仅限美国（IN、LA、MN、MT、NE 除外）；默认通话开头会播放录音告知。
这个 Agent 有哪些优点和局限？
- 接入面广：插件、MCP 连接器、Gemini CLI 扩展、Hermes、纯 HTTP 与 Apify Actor 覆盖了大部分主流智能体宿主。
- 结果可核查：每次通话返回 17 种核实过的 outcome 之一，附完整转写与录音，失败也会带原因（占线、语音信箱、空号等）。
- 无需自己找号码：suggest_places 可按自然语言描述推荐候选、解释理由并代写 call brief。
- 开通门槛低：浏览器 OAuth 登录即建账号并附免费额度，前 250 次通话免费（共 2,500 积分）。
- 计费偏保守：未取得任何结果的通话免费，接听后 30 秒内取消也免费。
- 托管闭源服务：通话在 voygr.tech 云端执行，无法自托管，也无法替换电话基础设施。
- 地域限制明显：目标号码仅限美国，且排除 IN、LA、MN、MT、NE 几个州。
- 多语言是尽力而为：13 种语言可选，但英文最可靠，非英文不做保证。
- 计费有预扣：每次通话预扣 30 积分、推荐预扣 15 积分，余额看似够也可能返回 402。
- 结果需要轮询：completed 后 outcome 与转写仍可能延迟补齐，录音检查还会追加标记。
- 部分能力仍要密钥：关闭录音、修改开场告知、取消通话、列出通话这些 API 选项在插件/连接器路径下仍需 API key。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| PlaceCall 当前 | 66 · 存在缺口 | Agent 插件 / 技能免费版 + 付费版 | ★ 104 | 2 天前 | Shell | ChatGPT · Codex · Claude Code · Claude.ai |
| Dokploy MCP 服务器 | 65 · 存在缺口 | MCP 服务器免费 | ★ 408 | 29 天前 | TypeScript | Claude Code · Claude.ai |
| Agent Swarm | 47 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 929 | 今天 | TypeScript | Codex · Claude Code |
| Open Browser Use | 36 · 缺口较多 | 命令行工具免费 | ★ 390 | 8 天前 | JavaScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 与 SECURITY.md 明确列出唯一出网主机 api.voygr.tech、每个端点携带的字段、密钥只放 X-API-Key 头、Idempotency-Key 防重复拨号、以及 90 天录音保留，数据流透明度充分（3）。但仓库本身只是指令与清单，真正的拨号、录音、IVR 处理都在远端服务，本地无法验证最小权限与敏感数据（通话录音、被叫号码、brief 中的姓名/日期）的实际处理，故 least_privilege 与 sensitive_data_handling 只给 2。用户确认方面 README 称 MCP 的 place_call 总是先确认，但这是对远端行为的断言，仓库内无代码佐证，给 2。外部副作用方面有“只拨打你有权拨打的号码”、默认录音告知、30 秒内取消免费等约束，但一次拨号即产生真实电话与费用，回滚仅限取消通话，无撤销已发生通话的手段，rollback 给 1。依赖安全方面仓库无锁文件、无依赖清单、无 SBOM，仅靠远端 API，无法评估，给 1。来源归属方面有 MIT 版权署名与 SECURITY 联系方式，但发布者身份未经 FollowAgents 验证，且“前 Google Maps/Search 开发者”属未经佐证的营销声明，给 1。
README 内部大体自洽（安装路径、密钥变量、端点、计费规则一致），但存在可疑时间线：称 2026-08 更名、2026 年版权，与“Installed this before August 2026”并存，且 Gemini CLI 段落对密钥存储与 curl 读取环境的描述前后略有张力，故 self_consistency 给 2。依赖可用性方面，安装依赖 Claude Code/Codex/Cursor/Gemini CLI 的插件市场、$skill-installer、hermes 等外部工具，且明确说旧版 Codex 无 plugin 命令、Hermes 扫描器会拒绝 skill 路线，可用性随环境波动且无版本约束，给 1。失败消息方面列出了 17 种结果、失败原因（掉线、占线、语音信箱、错号）、402 因预扣导致的误报、transcript_status 轮询等，较为具体，但均为文档描述而非代码，给 2。
受众与场景覆盖很广：Claude Code、Cowork、claude.ai、ChatGPT、任意 MCP 客户端、Codex、Hermes、Gemini CLI、Cursor、纯 shell、Apify，给 3。能力边界写得较清楚（仅美国号码、排除 IN/LA/MN/MT/NE、13 种语言且非英语尽力而为、auto 不中途切换、MCP 四工具与仅 API 选项的差异），但“17 种已验证结果”未列举，边界仍部分模糊，给 2。触发精度方面 skill 名为 /placecall:placecall、$placecall，并提醒删除旧 callwright 与第三方电话 skill 以避免路由歧义，但“Claude 会在你要求打电话时自动调用”属断言，给 2。环境适配方面对无终端桌面应用、沙箱 allowlist、strictAllowlist 阻断、密钥落盘权限等细节处理到位，给 3。
信息架构清晰，按平台分节并有锚点互链，给 3。安装说明极为详尽，含命令、scope 选择、重启要求、迁移步骤，给 3。命名稳定性不足：项目由 Callwright 更名、skill 目录从 skills/call 迁到 skills/placecall、环境变量改名，虽有迁移说明但历史断裂明显，给 2。示例与 FAQ 有 curl 示例和若干问答式段落，但无独立 FAQ、无结果字段示例、无 17 种 outcome 的枚举，给 2。已知限制有（地域、语言、计费预扣、录音保留、Hermes 不兼容），但未集中成节且缺少速率/并发上限说明，给 2。许可证为完整 MIT 文本，给 3。版本与变更日志缺失，仅零散提及 6.1.0 与 2026-08 更名，无 CHANGELOG，给 1。维护责任方面仅有 [email protected] 与 SECURITY 报告渠道，无维护者、SLA、弃用策略，且发布者未验证，给 1。
输出可用性方面承诺返回 outcome、transcript、recording 与失败原因，对下游 agent 可用，但仓库内无响应 schema 或示例载荷，需登录外部文档，给 2。边际价值方面把电话这一“最后的 API”封装为 agent 工具确有实际价值，但核心能力完全在闭源远端服务，仓库本身只是薄封装与文档，给 2。成本效益方面有 250 次免费、10 credits/次、30 credits 预扣、失败免费、Apify $0.10/次等透明定价，但预扣导致 402 误报与共享额度池增加使用摩擦，给 2。
claim_traceability 弱：17 种结果、总是先确认、90 天保留、前 Google 开发者等关键声明均无仓库内证据或外部可核链接，给 1。cross_source_corroboration 仅 README 与 SECURITY.md 两份文档互相呼应，无代码、测试、schema 或第三方佐证，给 1。fact_inference_separation 尚可：文档区分了“我们这一侧”与客户端行为、明确标注哪些是断言（如非英语尽力而为），但营销语与事实混排，给 2。
- 仓库仅为指令与清单，拨号、录音、IVR 处理均在远端闭源服务，无法静态验证最小权限、敏感数据实际处理与结果正确性。
- '17 种已验证结果'、'总是先确认'、'90 天保留'、'前 Google 开发者'等关键声明在仓库内无证据支撑，应视为未验证断言。
- 一次调用即拨打真实电话并产生费用；回滚仅限取消进行中的通话，已完成的通话无法撤销。
- 无依赖清单、锁文件或 SBOM，无法评估供应链安全。
- 项目曾更名（Callwright→PlaceCall）、目录与环境变量改名，旧安装可能造成路由歧义，需按迁移说明清理。
- 发布者身份未经 FollowAgents 验证，维护责任与更新路径仅有 support 邮箱。
- 计费预扣（30 credits）可能导致余额看似充足却返回 402，需注意额度池共享。
- 仅支持美国号码且排除 IN/LA/MN/MT/NE，非英语为尽力而为。