mcpField
S
send-sms-textbelt

send-sms-textbelt

github.com/gooseworks-ai生産性1.3k245 回インストール3 日前に更新
リポジトリ

send-sms-textbelt について

send-sms-textbelt は、Gooseworks API 経由で Textbelt から SMS を送るスキルです。送信状況の確認に加え、送信者名や返信 Webhook の任意パラメーターを指定できます。

主な機能

  1. 01Textbelt 経由の SMS 送信
  2. 02textId による状態確認
  3. 03任意の送信者名の指定
  4. 04返信 Webhook と追加データの設定

活用シーン

  1. 01電話番号宛てのメッセージ送信
  2. 02SMS の送信中・配達状況の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gooseworks-ai/goose-skills --skill send-sms-textbelt

インストール後、Claude Code で/send-sms-textbeltを入力して読み込まれたか確認します。

同梱ファイルskill.meta.json

詳細

テキストメッセージを送信する

セットアップ

認証情報を ~/.gooseworks/credentials.json から読み取ります：

export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")

~/.gooseworks/credentials.json が存在しない場合は、ユーザーに npx gooseworks login を実行するよう伝えてください。

すべてのエンドポイントでは Bearer 認証を使用します：-H "Authorization: Bearer $GOOSEWORKS_API_KEY"

Orthogonal 上の Textbelt API 経由で SMS メッセージを送信します。

ワークフロー

ステップ 1：情報を収集する

ユーザーに次の情報を尋ねます：

  • 電話番号（必須）- 米国／カナダ：市外局番を含む10桁。国際電話：E.164 形式（例：+44...）
  • メッセージ（必須）- 最大800文字。URLは使用できません。
ステップ 2：メッセージを送信する
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"textbelt","path":"/text"}'
  "phone": "<phone_number>",
  "message": "<message_text>"
}'
ステップ 3：配信を確認する

応答には textId が含まれます。これを使って配信状況を確認します：

curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
  -H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api":"textbelt","path":"/status/{textId}"}'

このエンドポイントは無料です。

応答

送信応答（/text）
  • success（ブール値）- メッセージがキューに登録された場合は true
  • textId（文字列）- 配信追跡用のメッセージ ID（成功時のみ）
  • quotaRemaining（整数）- 残りの SMS クレジット
  • error（文字列）- エラーメッセージ（失敗時のみ）
ステータス応答（/status/{textId}）
  • status（文字列）- DELIVERED、SENDING、FAILED、または UNKNOWN

制約

  • メッセージは1件あたり最大800文字です
  • メッセージ本文にURLを含めることはできません
  • 送信者名は省略可能で、ほとんどの国では受信者に表示されません

オプションのパラメーター

送信時に、次の情報も含めることができます：

  • sender（文字列）- 規制対応のための企業名／組織名
  • replyWebhookUrl（文字列）- 米国のみ：返信 Webhook の送信先 URL
  • webhookData（文字列）- Webhook に渡される追加データ（最大100文字）

エラー処理

  • success: false と error フィールドに問題の内容が記載されます（例：電話番号が無効、クレジット不足）
  • 米国／カナダの番号は、米国／カナダの IP 地域からのみ利用できます
  • 国際電話番号には E.164 形式が必要です（例：+44...）
  • URLを含むメッセージは拒否されます。代わりに説明文を使用してください
  • 最大800文字です。これを超えるメッセージは切り捨てられず、拒否されます

コメント

Markdown 対応