Community생산성 & 협업github.com

steipete/twilio-sms

Twilio SMS CLI: 전화번호 구매/목록/보관, 메시지 전송/확인, 자격 증명 라우팅.

twilio-sms란 무엇인가요?

이 스킬은 AI 에이전트가 Twilio API를 통해 전화번호와 SMS를 관리할 수 있게 해줍니다. 사용자가 전화번호를 구매, 목록화, 보관하고 SMS를 전송 및 확인할 수 있도록 지원합니다. 주로 Claude Code, Cursor, Codex와 같은 터미널 기반 AI 코딩 어시스턴트에서 사용되며, `twilio-cli` 또는 직접 REST API 호출을 통해 작업을 수행합니다. 스킬은 자격 증명 라우팅 로직을 포함하여 1Password, 환경 변수, Twilio CLI 프로필을 순차적으로 확인하며 안전하게 인증 정보를 처리합니다. 또한 전화번호 검색, 구매, 레이블 지정, 메시지 전송 및 수신 확인 기능을 제공하며, 민감한 정보(계정 SID, 인증 토큰 등)를 출력하지 않도록 안전 규칙을 엄격히 준수합니다.

지원 대상~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"

후보 번호 구매:

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 - <목적>"

보존 규칙: 번호가 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.

관련 스킬