mcpField
A
api

api

github.com/loops-so開発12137 回インストール3 日前に更新
リポジトリ

api について

アプリケーションコード、バックエンド、Webhook、自動化から Loops を実装するためのスキルです。公式 SDK と生の HTTP の選択を支援し、リクエストや検証の指針を示します。

主な機能

  1. 01SDK と生の HTTP を選択
  2. 02コンタクトとリストの操作を案内
  3. 03イベントとトランザクションメールに対応
  4. 04認証情報の確認とリクエストのトラブルシューティング
  5. 05アプリ開発と CLI 作業を区別

活用シーン

  1. 01バックエンドサービスに Loops を統合
  2. 02Webhook で Loops のイベントを処理
  3. 03コンタクト、プロパティ、メーリングリストを管理
  4. 04認証情報の確認や API リクエストの問題を調査

インストール

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

$npx skills add https://github.com/loops-so/skills --skill api

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

同梱ファイルreferences/http-api.md

詳細

Loops API と SDK のスキル

このスキルは、アプリケーションコードから Loops の実装ワークフローを行う際に役立ちます。バックエンドとの連携、正確なリクエストの指定、SDK または HTTP の選択に利用してください。

使用するタイミング

次のような場合に、このスキルを使用してください。

  • Loops をアプリ、バックエンド、Webhook、自動化に統合する
  • 公式 SDK と生の HTTP のどちらを使うか決める
  • コンタクト、コンタクトプロパティ、メーリングリスト、イベント、トランザクションメールを管理する
  • コードから認証情報を検証したり、Loops のリクエスト動作をトラブルシューティングしたりする

このスキルは、実装と運用での利用を対象としており、メール戦略全般や配信到達性の確認を対象としていません。

作業スタイル

このスキルが有効な場合：

  1. まず適切なインターフェース（SDK または生の HTTP）を選択します。
  2. その言語用の公式 SDK がある場合、アプリケーションコードでは公式 SDK を優先します。
  3. SDK がない場合、またはユーザーがペイロードを厳密に制御する必要がある場合に限り、生の HTTP を優先します。
  4. Loops へのリクエストはサーバー側で処理します。
  5. 詳細が重要な場合は、公式ドキュメントまたは OpenAPI 仕様で正確な動作を確認します。
  6. 主な作業が Loops CLI のインストール、認証、シェルでの使用、またはコマンドのヘルプに関する場合は、別の cli スキルを使用します。

公式リファレンス：

  • ドキュメント：https://loops.so/docs
  • API リファレンス：https://loops.so/docs/api-reference/intro
  • JavaScript SDK：https://loops.so/docs/sdks/javascript
  • OpenAPI 仕様：https://app.loops.so/openapi.json

インターフェースの選択

  • SDK または HTTP API：
    • アプリケーションコード
    • バックエンドサービス
    • Webhook ハンドラー
    • 繰り返し利用する連携 references/http-api.md を読みます。

ユーザーがアプリケーションコードを書くのではなく、ターミナルで作業している場合は、cli スキルを使用します。

カテゴリー別の案内

  • 認証、ベース URL、レート制限、コンタクト、プロパティ、リスト、イベント、トランザクションのペイロード、SDK の例、HTTP エラー： references/http-api.md を読みます。

出力チェックリスト

ユーザーに次の情報を提供できるようにします。

  • タスクに適した API インターフェースの選択
  • 正確なペイロード形式または SDK の使用方法
  • 動作に影響する Loops 固有の注意事項
  • 簡単なテストリクエストや API キーの確認など、次の検証手順

コメント

Markdown 対応