PlaceCall

PlaceCall

PlaceCall を使うと、エージェントが米国内の企業に電話し、予約の手配、情報の収集、見積もりの取得を行えます。結果と通話の文字起こしが返されます。最初の 250 件の通話は無料です。Google Maps と Search の元開発者が開発しました。

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"}'

上記の生 API では、X-API-Key ヘッダーにキーを指定します。https://api.voygr.tech/checkout で取得すると、メールで届きます。以下のプラグインと MCP コネクターでは、ブラウザーからサインインします。エージェントにブラウザーがない場合は、メールコードを使って登録できます。メールコードで登録をご覧ください。

PlaceCall の機能

米国内の電話番号（または番号のリスト）と、問い合わせ、見積もり依頼、予約などのタスクを平易な英語で PlaceCall に渡します。PlaceCall は発信し、自動音声応答システムや保留に対応しながら、企業と会話します。

電話番号がない場合は、たとえば「シカゴにあるロマンチックなレストラン、土曜日の午後 8 時」のように場所を説明してください。PlaceCall が候補を見つけ、選んだ理由を説明し、通話の概要を作成します。

依頼内容全体を brief に記載してください。質問する内容、誰のための依頼か、名前、日付、人数、折り返し先の電話番号、希望する結果、通話の締めくくり方などを含めます。ボットは brief の内容だけを読みます。さらに情報が必要な場合は、通話中に質問します。

対応できること

• テーブルや予約の予約、キャンセル、日時変更
• 情報の確認、注文のフォローアップ、在庫の確認、見積もりの取得
• 多数の企業への一斉連絡
• 電話番号がわからない場合に、最適な会場、サービス、業者を推薦
• 通話結果を報告し、必要に応じて通話中に質問を提示

返される情報

各通話では、17 種類の検証済み結果のいずれかに加えて、完全な文字起こしと録音が返されます。通話に失敗した場合は、切断、話し中、留守番電話、間違い電話など、その理由が返されます。

インストール

Claude Code、Codex、Cursor のプラグインには、スキルと PlaceCall MCP サーバー（https://api.voygr.tech/mcp）が含まれています。ブラウザーで一度サインインしてください。初回サインイン時に無料クレジット付きの PlaceCall アカウントが作成されるため、キーをコピーする必要はありません。claude.ai と ChatGPT のコネクターも同じ仕組みです。スキルのみの方法（コピーしたスキル、Codex スキルインストーラー、OpenClaw）では、代わりにキーを使って API を呼び出します。キーを取得をご覧ください。Gemini CLI 拡張機能にも MCP サーバーが含まれていますが、キーをサーバーに送信する方式で、ブラウザーからのサインインには対応していません。

サインインすれば、場所の検索、通話の発信、通話のフォローアップができます。一部の API オプションは、どの方法でもキーが必要です。録音の無効化や冒頭の通知の変更、通話のキャンセル、通話一覧の取得が該当します。

Claude Code（推奨）

プラグインはこのリポジトリから自動更新されます。2 つのコマンドでインストールできます。シェルや git は不要です。

/plugin marketplace add voygr-tech/placecall
/plugin install placecall@placecall

Claude Code でインストール先を尋ねられたら、1 つのリポジトリだけに限定する場合を除き、ユーザースコープ（「自分用にインストール」）を選んでください。次に /mcp を実行し、placecall サーバーを選択してサインインします。スキルは /placecall:placecall で呼び出せます。また、誰かに電話するよう依頼すると、Claude が必要に応じて自動的にこのスキルを使います。

6.1.0 より前のバージョンのプラグインをインストールしましたか？/plugin marketplace update placecall を実行し、Claude Code を再起動してください。すでにキーをエクスポートしている場合は、サインインする必要はありません。スキルは、既存のアカウントとクレジットを使って、引き続きすべての通話にキーを使用します。キーがない場合は、/mcp からサインインしてください。

プラグインを使わずに Claude Code を使う場合

git clone https://github.com/voygr-tech/placecall && cd placecall
./install.sh     # copies skills/placecall/SKILL.md -> ~/.claude/skills/placecall/

install.sh は skills/placecall/SKILL.md をスキルディレクトリにコピーするだけです（ネットワーク接続や、それ以外の副作用はありません）。そのため、ファイルを手動でコピーすることもできます。スキルは起動時に読み込まれるため、新しい Claude Code セッションを開始してください。コピーしたスキルは自動更新されません。今後リリースされる新しいスキルや修正を利用するには、上記のプラグインを使ってください。

Cowork

Claude コネクターを使用します。claude.ai チャットの下にある手順で一度追加すれば、Claude チャット、Cowork、Claude Desktop で利用できます。キーもターミナルも必要ありません。

このプラグインは Cowork にもインストールできます（Customize > Plugins > Add marketplace を選び、voygr-tech/placecall を貼り付けて Install）。ブリーフの作成と通話後のフォローアップに関するスキルのガイダンスが追加され、同じ PlaceCall サーバーに接続します。どちらか一方をインストールしてください。両方をインストールすると、エージェントには同じツールを提供する PlaceCall サーバーが2つ表示されます。

録音の停止、カスタムの冒頭通知、通話のキャンセルなど、API でのみ利用できるオプションが必要ですか？コネクターの代わりにプラグインをインストールし、スキルにキーを設定してください。キーとサンドボックスの許可リストの両方を ~/.claude/settings.json に記述します。Cowork にはターミナルがないため、キーを取得するにある export を実行する場所がありません。また、Bash サンドボックスは許可するまで API へのアクセスをブロックします。

{
  "env": { "PLACECALL_API_KEY": "<your key>" },
  "sandbox": { "network": { "allowedDomains": ["api.voygr.tech"] } }
}

その後、Cowork を再起動してください。

• env を使うと、再起動後もキーが維持されます。シェルで設定してもデスクトップアプリには引き継がれません。デスクトップアプリからそのシェルは参照できないためです。
• allowedDomains によって api.voygr.tech が事前に許可されます。Claude Code ではドメインが事前に許可されないため、これがないと初回の通話時に許可を求めるメッセージが表示されます。組織で strictAllowlist または allowManagedDomainsOnly が設定されている場合、メッセージは表示されず、通話はブロックされます。これを「deep admin setting」と呼ぶ人もいます。

キーはこのファイルに平文で保存されます。キーを取得するにある 600 の環境ファイルと同じ信頼レベルです。 ファイルの権限も同じにしたい場合は、chmod 600 ~/.claude/settings.json を実行してください。

claude.ai チャット

サインイン付きのカスタムコネクターを使えば、すべてのプランで利用できます。

個人プランの場合：Settings > Connectors > Add custom connector。 Team／Enterprise の場合：Owner が Organization settings > Connectors で一度追加すると、各メンバーは自分の PlaceCall アカウントでサインインできます。

1. 名前に PlaceCall、URL に https://api.voygr.tech/mcp を指定します。Claude が検出するサインイン設定はそのままにします。
2. Add を選び、Google またはメールアドレスでサインインします。初回サインイン時に利用規約とプライバシーポリシーに同意すると、無料クレジット付きの PlaceCall アカウントが作成されます。
3. アクセスを許可します。PlaceCall はチャットのツールメニューに表示されます。ここから、電話する価値のある場所を探し、通話を発信し（必ず事前に確認します）、結果を取得できます。

ワークスペース全体で1つの API キーを使いたい場合は、No sign-in を選んでコネクターを追加し、Request ヘッダー x-api-key にキーを指定します。以降のすべての通話は、そのキーに課金されます。

ChatGPT

Web 版 ChatGPT で、PlaceCall をカスタムアプリとして追加します。カスタムアプリの利用可否は ChatGPT のプランによって異なります。

1. Plugins を開き、+ > Create plugin > Create MCP App を選びます。
2. 名前に PlaceCall、サーバー URL に https://api.voygr.tech/mcp、認証に OAuth を指定します。ChatGPT が検出した OAuth 設定はそのままにし、カスタムアプリの通知に同意して Create を選びます。
3. Google またはメールアドレスでサインインします。初回サインイン時に利用規約とプライバシーポリシーに同意すると、無料クレジット付きの PlaceCall アカウントが作成されます。
4. チャットでツールメニューから PlaceCall を選びます。

任意の MCP クライアント（Cursor、Windsurf、MCP Inspector など）

クライアントの接続先を https://api.voygr.tech/mcp（ストリーミング可能な HTTP トランスポート）に設定します。公式 MCP Registry には io.github.voygr-tech/placecall として登録されています。クライアントが対応している場合は OAuth でサインインするか、次のいずれかのヘッダーで毎回のリクエストにキーを指定します。

X-API-Key: <your key>

または Authorization: Bearer <your key>。

Claude Code は独自の MCP 設定を使用するため（claude.ai のコネクターは引き継がれません）、次のコマンドで追加します。

claude mcp add --transport http --scope user placecall https://api.voygr.tech/mcp

次に Claude Code で /mcp を実行し、placecall を選んでサインインします。代わりにキーを使う場合は、--header "X-API-Key: <your key>" を追加します。--scope user を指定すると、すべてのプロジェクトで利用できます。このページの冒頭にあるプラグインは、4つのツールに加えて完全なスキルも含むため、Claude Code には引き続きこちらがおすすめです。

Codex

Claude Code と同じプラグインです。シェルで次のコマンドを実行してください。

codex plugin marketplace add voygr-tech/placecall
codex plugin add placecall@placecall
codex mcp login placecall

最後のコマンドを実行すると、ブラウザーでサインイン画面が開きます。お使いの Codex に plugin コマンドがない場合は、Codex を更新するか、以下のスキルインストーラーを使用してください。

スキルのみをインストールしてキーを使用するには、シェルではなく Codex 内で次のように入力してください。 $skill-installer は Codex に組み込まれているシステムスキルなので、事前のセットアップは不要です。

$skill-installer install the skill at https://github.com/voygr-tech/placecall/tree/main/skills/placecall and name it placecall

これはコマンドではなくスキルなので、自然な英語で指示してください。インストールを実行し、スキルのインストール先を報告します。再起動は不要です。次のターンからスキルを利用でき、$placecall に応答します。

上記の指示を Codex が理解しない場合は、通常のシェルからインストーラーのスクリプトを実行してください。

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --url https://github.com/voygr-tech/placecall/tree/main/skills/placecall \
  --name placecall

インストーラーは既存ファイルを上書きしません。そのため、~/.codex/skills にすでに placecall（または以前の callwright）スキルがある場合は、先に削除してください。削除しないとインストールが中止されます。Codex では install.sh を実行しないでください。このスクリプトは Claude Code 用です。

スキルフォルダーは 2026 年 10 月に skills/call から skills/placecall に移動しました。そのため、まだ .../tree/main/skills/call と記載されているインストール行では見つかりません。すでにインストール済みのコピーは引き続き動作し、$placecall に応答します。新しいバージョンを利用するには、削除して上記の skills/placecall URL から再インストールしてください。

$skill-installer がない旧バージョンの Codex をお使いの場合や、任意の Codex で別の方法を使う場合は、このリポジトリの AGENTS.md をプロジェクトの AGENTS.md に貼り付けてください。

Hermes Agent

コマンドは 1 つだけです。キーはコマンドライン引数としてではなく、プロンプトで入力するため、シェルの履歴に残りません。

hermes mcp add placecall --url https://api.voygr.tech/mcp/ --auth header

URL の末尾のスラッシュは残してください。「Does this server require authentication?」には Y と回答し、マスクされたプロンプトでキーを貼り付けてから、4 つすべてのツールを有効にするかどうかにも Y と回答してください。Hermes はキーを ~/.hermes/.env に（MCP_PLACECALL_API_KEY として）保存し、config.yaml には ${...} の参照のみを書き込むため、キーの値が設定ファイルに記録されることはありません。hermes mcp test placecall で確認してから、新しいセッションを開始してください。ツールはセッション開始時に読み込まれるためです。

Hermes ではスキルを使わないでください。Hermes 独自のスキャナーは hermes skills install placecall を拒否します。API キーを curl でループバック以外のホストに送信するスキルは、このスキャナーの設計上、重大な問題として検出されます。このスキルは呼び出しのたびにその処理を行います。MCP にはシェルもリクエスト内の環境変数もないため、このルールは適用されません。

Gemini CLI

このリポジトリは Gemini CLI 拡張機能でもあります。スキルと PlaceCall MCP サーバーが含まれます。シェルからインストールしてください。

gemini extensions install https://github.com/voygr-tech/placecall

インストール時に PlaceCall API キーの入力を求められ、システムのキーチェーンに保存されます（後から gemini extensions config placecall で変更できます）。Gemini は保存したキーを MCP サーバーにのみ渡します。スキルの curl コマンドはシェルで実行され、そこから PLACECALL_API_KEY を読み取るため、この環境変数もエクスポートしてください（キーを取得するを参照）。キーをエクスポートしていて、キーチェーンには保存していない場合も、MCP サーバーは環境変数からキーを取得します。

Cursor

このリポジトリは Cursor プラグイン（.cursor-plugin/plugin.json）でもあります。スキルと、OAuth でサインインする PlaceCall MCP サーバー（https://api.voygr.tech/mcp）が含まれるため、プラグインにキーは保持されません。Cursor Marketplace に掲載される前に読み込むには、Cursor のローカルプラグインフォルダーにクローンし、Developer: Reload Window を実行してください。

git clone https://github.com/voygr-tech/placecall ~/.cursor/plugins/local/placecall

スキルの curl コマンドは、Cursor のエージェントが実行される環境から PLACECALL_API_KEY を読み取ります。サインインする代わりに MCP サーバーへキーを渡す方法については、任意の MCP クライアントを参照してください。

あらゆるエージェント／通常のシェル

インストールは不要です。API は通常の HTTP です。 skills/placecall/SKILL.md にリファレンスのすべてが記載されており、シェル ツールを備えたモデルなら、そこから直接電話をかけられます。

お使いの環境にシェルがありませんか？ 独自のコンピューターを持つアシスタント（例：Meta Muse） は、このリポジトリから直接連携できます。チャットにリポジトリの URL を貼り付け、 PlaceCall を使って電話をかけるよう依頼してください。API キーの安全な認証情報ストレージが 利用できる場合はそれを使い、キーをチャットに貼り付けないでください。

この方法で動作することが確認されているもの：Meta Muse、OpenClaw（DeepSeek バックエンド）。Hermes では 上記のスキルではなく、MCP の方法を使う必要があります。この連携を構築するエージェントの場合は、 すべてのリクエストに X-Client-Surface: <your-platform> を含めてください。どの 環境への対応が必要かを把握できます。

Apify Store（コード不要、一覧をまるごと処理）

エージェントではなく事業者の一覧をお持ちですか？ Apify Store の PlaceCall は 一覧内のすべての事業者に電話をかけ、設定した質問をして、電話ごとに 1 行を返します。PlaceCall のキーは不要です。Apify が実行し、料金を請求します。

1. Actor を開き、Try for free を押します（Apify アカウントが必要です）。
2. 一覧を用意します。CSV をアップロードする、Google Sheet のリンクを指定する、行を貼り付ける、または たとえば Google Maps の検索結果など、別の Actor のデータセットを使います。
3. 質問を入力し、Check my list, don't call にチェックを入れたまま Start を押します。 各事業者に尋ねる内容を無料で正確に確認できます。
4. PlaceCall の利用規約に同意し、チェックを外して再度開始します。

実際に会話につながった通話は 1 件あたり $0.10 です。応答のない通話、留守番電話、 話し中の場合は無料です。各 Apify アカウントでは最初の 10 件の通話が無料で、その後は 有料の Apify プランが必要です。Apify MCP サーバーに接続されたエージェントも PlaceCall を見つけて実行できます。

キーを取得（セルフサービス）して設定する

プラグインまたはコネクタからサインインしましたか？ キーが必要なのは、MCP ツールでは できない操作（録音を無効にする、冒頭の通知を変更する、通話をキャンセルする、通話一覧を表示する）に限られます。スキルのみの方法と生の API では、電話をかける際にキーが必要です。誰かに連絡する必要はありません。ブラウザーを使えない場合は、 エージェントがメールコードで登録できます。 それ以外の場合：

1. https://api.voygr.tech/checkout?src=gh-repo を開き、"Get free API key" をクリックします （名前＋メールアドレス）。
2. キーはメールで届きます。新しいキーに含まれる内容と現在のクレジット料金は、チェックアウトページに表示されます。
3. キーを紛失しましたか？ https://api.voygr.tech/recover から新しいキーをメールで受け取れます。
4. クレジットを追加しますか？ 同じ https://api.voygr.tech/checkout?src=gh-repo ページでチャージしてください（Stripe がホストする決済ページ）。

続いて、シェルでキーを設定します。

現在のセッションでのみ設定するには：

export PLACECALL_API_KEY="<your key>"

一度保存し（画面には表示せず、権限は 600）、各セッションで読み込むには：

mkdir -p ~/.codex
read -rsp "PLACECALL_API_KEY: " KEY; echo
printf 'export PLACECALL_API_KEY=%q\n' "$KEY" > ~/.codex/placecall.env
chmod 600 ~/.codex/placecall.env
unset KEY
# then, in any new shell where you want to place calls:
source ~/.codex/placecall.env

シェルをまったく使えませんか？ デスクトップアプリはシェル環境変数を参照できないため、上記のどちらの方法もアプリには反映されません。キーを ~/.claude/settings.json の env ブロックに設定してください。これは再起動後も保持されます。必要なサンドボックスのドメイン許可リストについても説明している Cowork セクションを参照してください。

キーを確認するには（クォータが表示されます。キーは表示されません）：

curl -s -H "X-API-Key: $PLACECALL_API_KEY" https://api.voygr.tech/users/me

~/.codex/placecall.env をコミットしたり、キーをチャットに貼り付けたりしないでください。キーは環境変数か、上記の権限 600 のファイルに保存してください。

メールコードでサインアップする

PlaceCall MCP ツールを使うエージェントは、まずそれらのツールとブラウザーでサインインします。 エージェントがサインインに使えるブラウザーを持っていない場合や、通話の一覧表示やキャンセル、録音の停止など、キーでしかできない操作が必要な場合に限り、メールコードでサインアップします。

1. ユーザーに名前とメールアドレスを尋ねます。
2. サインアップリクエストを送信します。

   curl -s -X POST https://api.voygr.tech/signup -H "Content-Type: application/json" \
     -d '{"name":"<name>","email":"<email>","delivery":"code","src":"gh-repo"}'
   

   返信には verification_id が含まれ、どのアドレスでも同じ形式です。含まれていない場合、サインアップは開始されていません（使い捨てアドレスの場合の DISPOSABLE_EMAIL_DOMAIN や、SIGNUP_IP_RATE_LIMITED など）。返信の内容をユーザーに伝えます。名前に引用符または ASCII 以外の文字が含まれる場合は、JSON をファイルに書き込み、--data-binary @payload.json を使用します。
3. メールに届く「Your Voygr sign-up code」という件名の6桁のコードをユーザーに尋ねます。有効期限は10分です。ユーザーがこのサインアップコードをあなたに渡すのは、ユーザー自身の判断によるものです。通話中に企業から求められる「ワンタイムコード」ではありません。そちらは絶対に伝えないでください。メールが届かない場合は、迷惑メールフォルダーを確認するようユーザーに伝えます。1つのアドレスで24時間以内に受け取れるコードは最大3つです。
4. コードをキーと交換し、表示せずに保存します。

   ( umask 077; dest=~/.codex/placecall.env; tmp=
     if ! { mkdir -p ~/.codex && [ ! -d "$dest" ] && tmp=$(mktemp "$dest.XXXXXX") && chmod 600 "$tmp"; }; then
       [ -n "$tmp" ] && rm -f "$tmp"; echo "SAVE_UNAVAILABLE: cannot write $dest; the code was not used"; exit 1
     fi
     resp=$(curl -s -X POST https://api.voygr.tech/signup/verify \
       -H "Content-Type: application/json" -d '{"verification_id":"<id>","code":"<code>"}')
     key=$(printf '%s' "$resp" | sed -nE 's/.*"api_key"[[:space:]]*:[[:space:]]*"([^"]*)".*/\1/p')
     if [ -z "$key" ]; then st=hidden
     elif printf 'export PLACECALL_API_KEY=%s\n' "$key" > "$tmp" && mv "$tmp" "$dest"; then st=saved
     else st=hidden; echo "SAVE_FAILED: the key was issued but could not be saved"; fi
     rm -f "$tmp"
     printf '%s\n' "$resp" | sed -E "s/\"api_key\"[[:space:]]*:[[:space:]]*\"[^\"]*\"/\"api_key\":\"($st)\"/" )
   

5. 出力に "api_key":"(saved)" と表示された場合は、キーが ~/.codex/placecall.env に保存されたこと、およびコードを入力したことで API 利用規約（https://voygr.tech/terms-api）に同意したことをユーザーに伝えます。返信に "replaced_previous_key":true が含まれる場合は、以前のキーが使えなくなったことも伝えます。

手順4でエラーが返された場合は、error_code を確認します。

• CODE_INCORRECT：コードをもう一度確認するようユーザーに伝えます。attempts_remaining に残りの試行回数が表示されます。
• CODE_INVALID_OR_EXPIRED：手順2からやり直します。
• SIGNUP_CAPPED、SIGNUP_VERIFY_UNAVAILABLE、または account_status_unavailable：1分待ってから、同じコードで手順4を繰り返します。
• KEY_EXPIRED または ACCOUNT_WITHOUT_PLACECALL：ユーザーに伝え、[email protected] を案内します。
• ROTATION_FAILED、またはその他のエラー：返信の内容をユーザーに伝えます。

手順4で代わりに SAVE_ で始まる行が出力された場合、キーは保存されていません。

• SAVE_UNAVAILABLE：コードは使用されていません。フォルダーまたはディスクの問題を修正してから、同じコードで手順4を繰り返します。
• SAVE_FAILED：キーは発行されましたが、保存できませんでした。ユーザーに伝え、返信に "replaced_previous_key":true が含まれる場合は、以前のキーが使えなくなったことも伝えます。問題を修正してから、手順2からやり直します。新しいコードで失われたキーを置き換えます。

これを2026年8月より前にインストールしましたか？

このプロジェクトは2026-08まで Callwright という名前で、リポジトリは voygr-tech/callwright-skill にありました。

• 既存のセットアップはそのまま動作します。install.sh はスキルをリンクせずにコピーするため、以前にインストールしたコピーは当時の状態のまま残り、名称変更によって動作しなくなることはありません。同じコピーに新しいスキルや修正が反映されることはありません。これが移行する理由です。
• 移行するには、まず古いコピーを削除してください。これは引き続き動作する電話スキルなので、そのまま残しておくとエージェントに同じものが2つ設定され、どちらに振り分けるかが曖昧になります。現在の install.sh は、古いコピーを見つけると警告します。

  rm -rf ~/.claude/skills/callwright ~/.claude/skills/callwright-skill
  

  その後、上記のプラグインをインストールし、新しい名前 PLACECALL_API_KEY でキーを再度エクスポートします。キー自体は変わらず、変わったのは変数名だけなので、何かを再発行する必要はありません。

以前、別の提供元から電話通話スキル（例：ai-call-agent）をインストールしていた場合も、同じ理由で削除するか無効にしてください。

知っておくとよいこと

• 回答、拒否、予約のいずれかを取得できた場合、1 回の通話につき 10 クレジットかかります。通話中は 30 クレジットが確保され、終了時に未使用分が解放されます。何も取得できなかった通話は無料です。また、相手が応答してから 30 秒以内にキャンセルした場合も無料ですが、応答から 30 秒以上経過してからキャンセルすると課金されます。場所の候補の提案も同じ残高を使用します。回答があった POST /v1/places/suggest 1 回につき 5 クレジット（処理中は 15 クレジットを確保）で、カードが返されなかった場合や拒否された場合は無料です。確保額は課金額より大きいため、課金額だけを見ると残高が十分に見えても、どちらも 402 を返すことがあります（残高は GET /users/me で確認できます。料金とチャージは https://api.voygr.tech/checkout?src=gh-repo からセルフサービスで利用できます）。 無料枠は共通の残高です。無料通話 250 回分は 2,500 クレジットで、場所の候補の提案も同じ 2,500 クレジットを使用します。
• 通話が completed になった後、ステータスが切り替わってから少し遅れて、結果と文字起こしが反映されることがあります。そのため、outcome_type が null でなくなるまで GET /calls/{id} をポーリングしてください。その後 1～2 分ほどは、通話録音の確認によって文字起こしにマークが追加される場合があります。transcript_status が final になれば、文字起こしは完成です。
• 受け付けられる言語コードは 13 種類（en、es、fr、de、hi、ru、pt、ja、it、nl、sr、tr、pl）と auto（デフォルト。通話は英語で行われ、通話中に言語は切り替わりません。スペイン語で通話する場合は es を指定してください）です。最も信頼性が高いのは en です。英語以外の言語はベストエフォートです。
• 通話するのは、通話する権限のある電話番号に限ってください。すべての通話で実際の電話が鳴ります。米国内の宛先のみ利用できますが、IN、LA、MN、MT、NE は対象外です。デフォルトでは、すべての通話の冒頭で回線が録音されることを通知します（英語とスペイン語では PlaceCall の名前も伝えます）。省略可能な disclosure フィールドと record_call フィールドで、この冒頭の通知を変更またはオフにできます。スキルの「冒頭の通知」セクションを参照してください。

ネットワークアクセス

このスキルには、単独で動作するものは含まれていません。エージェントが従う指示であり、PlaceCall MCP ツールを接続したプラグインを使うか、独自のシェルで curl を使います。すべてのリクエストは HTTPS 経由で、単一のホスト api.voygr.tech に送信されます。それ以外の場所には何も送信されません。

• MCP サーバー：Claude Code、Codex、Cursor のプラグインと Gemini CLI 拡張機能は、https://api.voygr.tech/mcp を登録します。suggest_places は自然な言葉でのリクエストと任意の場所を送信し、place_call は電話をかける番号、簡単な説明、言語を送信します。get_call_result は通話 ID を送信し、answer_question は通話 ID、質問 ID、回答を送信します。

• 通話：POST /calls は電話をかける番号、簡単な説明、言語を送信します。GET /calls、GET /calls/{id}、GET /calls/{id}/events（通話中にポーリング）、POST /calls/{id}/answer（通話エージェントが通話中に尋ねる質問への返信）、POST /calls/{id}/cancel、GET /calls/{id}/recording で通話を追跡・確認できます。

• 電話をかける場所の検索：POST /v1/places/suggest は自然な言葉でのリクエストと、入力した場合は名前および折り返し先の電話番号を送信します。

• アカウント：GET /users/me、GET /v1/usage、GET /checkout/packs、GET /skills/{id}/manifest、PUT /users/me/limits。

• メールコードによる登録：POST /signup は名前とメールアドレスを送信し、POST /signup/verify はメールで届いたコードを送信します。

MCP サーバーでは、Claude Code、Codex、Cursor のプラグインは OAuth でサインインし、クライアントはキーではなく、その結果得られたアクセストークンを送信します。一方、Gemini CLI 拡張機能は X-API-Key ヘッダーでキーを送信します。2 つの登録用リクエストを除くすべての curl リクエストは、X-API-Key ヘッダーでキーを送信します。登録用リクエストではキーを送信せず、POST /signup/verify がキーを返します。いずれの場合も、PLACECALL_API_KEY が送信されるのは api.voygr.tech のみです。POST /calls は、認証や課金に影響しない次の 3 つのヘッダーも送信します。再試行によって二重に発信されないようにする Idempotency-Key、これらの指示の入手元となった掲載ページを示す X-Client-Surface、発信に使ったツールを示す X-Client-Agent（CLAUDECODE、CURSOR_AGENT、CODEX_SANDBOX、GEMINI_CLI のうち設定されている変数から判定し、claude-code、cursor、codex、gemini-cli のいずれかを送信します。送信されるのは名前のみで、変数の値は送信されません）。

このスキルが読み取るローカルファイルは、保存済みのキーがある ~/.codex/placecall.env のみで、PLACECALL_API_KEY が設定されていない場合に限ります。メールコードによる登録でも、このファイルに書き込みます。install.sh はネットワークアクセスを行いません。この README にあるチェックアウト、復元、ドキュメントへのリンクは、ユーザーが開くためのページです。このスキルがそれらを取得することはありません。

当社側では、実際の電話に発信し、通話を録音します。録音と文字起こしは 90 日間保存されます。セキュリティに関する報告：SECURITY.md。

完全なリファレンス：skills/placecall/SKILL.md（Claude Code）・AGENTS.md（Codex）。

API ドキュメント（最新）：https://api.voygr.tech/docs。PLACECALL_API_KEY に設定したものと同じ PlaceCall キーでログインしてください。

PlaceCall が役に立ったら、このリポジトリにスターを付けてください。とても励みになります。