steipete/twilio-sms

Twilio SMS CLI: 番号の購入/一覧/管理、メッセージ送信/確認、認証情報ルーティング。

twilio-sms とは?

このスキルは、Twilioの電話番号管理とSMS送受信をコマンドラインから行うためのAIエージェントスキルです。主にClaude CodeやCursor、Codexといった開発者向けAIエージェントで動作し、Twilio CLIとREST APIを適切に使い分けながら、番号の購入・一覧表示・保持、SMSの送信・ステータス確認・受信メッセージチェックなどを安全に実行します。セキュリティ面に配慮しており、アカウントSIDや認証トークンなどの機密情報をログやレスポンスに出力しないよう徹底されています。認証情報は環境変数と1Passwordを連携して取得するルーティング機構を持ち、必要に応じてTwilio CLIプロファイルの作成や認証確認を自動実行します。番号購入時にはA2P/10DLCコンプライアンスにも対応し、トライアルアカウント制限への注意も促します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/twilio-sms

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Twilio SMS

Twilioの電話番号とSMSに関する作業に使用します: 番号の作成/購入、所有番号の一覧表示、番号の保持/ラベル付け、テキスト送信、受信/送信メッセージの確認。

安全性

  • アカウントSID、認証トークン、APIシークレット、TOTPコード、完全な1PasswordアイテムJSONを決して出力しないでください。
  • 実際の電話番号、SID、名前、アカウント固有のアイテムIDをこのスキル内に保存しないでください。
  • シークレットの読み取りには $one-password を使用してください。op はtmux専用です。
  • デスクトップの1Passwordアクセスが必要な場合は、それらのコマンドでサービスアカウント認証を解除してください: env -u OP_SERVICE_ACCOUNT_TOKEN op ...。
  • 認証情報の形状のみ出力: フィールドが存在するか、長さ、プレフィックス(有用な場合のみ)。
  • 公開書き込みやログ: ユーザーがSMSの読み取り/確認を明示的に要求しない限り、メッセージ本文を漏洩させないでください。

認証情報ルート

  1. Twilio CLI/プロファイルを確認:
    • twilio --version または npx -y twilio-cli --version
    • twilio profiles:list または npx -y twilio-cli profiles:list
  2. 環境変数の有無のみ正確に確認:
    • TWILIO_ACCOUNT_SID
    • TWILIO_AUTH_TOKEN
    • 任意: APIキー/シークレット変数
  3. 環境変数が部分的にしか存在しない場合、まず1Passwordのメタデータを検索してください。
  4. 以下のフィールドに一致するアイテムを優先:
    • TWILIO_ACCOUNT_SID
    • TWILIO_AUTH_TOKEN
    • 任意: TWILIO_FROM_NUMBER
  5. op が制限されたボルトしか認識できない場合、env -u OP_SERVICE_ACCOUNT_TOKEN を使用してデスクトップ経由の読み取りを再試行してください。
  6. 購入/送信の前に認証を確認:
curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID.json"

CLIセットアップ

Twilio CLIプロファイルの作成にはAPIキー認証情報ではなくアカウント認証トークンが必要です:

npx -y twilio-cli profiles:create "$TWILIO_ACCOUNT_SID" \
  --auth-token "$TWILIO_AUTH_TOKEN" \
  --profile default --force --silent
npx -y twilio-cli profiles:use default

twilio がインストールされていない場合は npx -y twilio-cli を使用してください。

番号

所有番号の一覧表示:

npx -y twilio-cli api:core:incoming-phone-numbers:list \
  --properties phoneNumber,friendlyName,capabilities

米国内のSMS対応番号を検索:

npx -y twilio-cli api:core:available-phone-numbers:local:list \
  --country-code US --sms-enabled --voice-enabled --limit 5

CLIの形状が扱いにくい場合やフラグがない場合は、RESTを使用:

curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/AvailablePhoneNumbers/US/Local.json?SmsEnabled=true&VoiceEnabled=true&PageSize=5"

候補を1つ購入:

curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json" \
  --data-urlencode "PhoneNumber=$PHONE_NUMBER"

購入後に所有権/機能を確認。Twilio JSONは小文字のキーを使用:

capabilities.sms
capabilities.mms
capabilities.voice

ユーザーが保持したい番号をマーク:

npx -y twilio-cli api:core:incoming-phone-numbers:update \
  --sid "$PHONE_NUMBER_SID" \
  --friendly-name "KEEP - <purpose>"

保持ルール: 番号はTwilioアカウントに残り、課金が正常である限り保持されます。明示的に要求されない限り、リリース/削除しないでください。

SMS

送信:

npx -y twilio-cli api:core:messages:create \
  --from "$FROM_NUMBER" \
  --to "$TO_NUMBER" \
  --body "$BODY" \
  -o json

ステータス取得:

npx -y twilio-cli api:core:messages:fetch --sid "$MESSAGE_SID" -o json

番号への受信メッセージを確認:

npx -y twilio-cli api:core:messages:list \
  --to "$NUMBER" --limit 20 -o json

番号からの送信メッセージを確認:

npx -y twilio-cli api:core:messages:list \
  --from "$NUMBER" --limit 20 -o json

Twilio CLI JSONは単一リソースコマンドでも配列を返す場合があります。防御的にパース:

jq 'if type=="array" then .[0] else . end'

注意事項

  • 国際SMSでは、購入した米国番号の代わりに英数字またはキャリア送信者として表示される場合があります。
  • 米国SMSはコンプライアンスの対象となる場合があります。米国の受信者への送信に失敗した場合は、盲目的に再試行する前にA2P/10DLC登録状況を確認してください。
  • トライアルアカウントでは受信者が制限される場合があります。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

関連スキル