Communitygithub.com

membranedev/application-skills

Waitlist インテグレーション。データ、レコードの管理とワークフローの自動化を行います。ユーザーが Waitlist データを操作したい場合に使用します。

application-skills とは?

このスキルは、SaaSアプリケーション「Waitlist」と連携するための機能を提供します。Waitlistは、製品ローンチやイベントのための待機リストを作成・管理し、リードを獲得して期待感を醸成するためのツールです。主にマーケティングチームやプロダクトマネージャーが利用します。 このスキルはMembrane CLIを通じてWaitlistと連携し、認証や認証情報の更新を自動的に処理するため、ユーザーは認証周りの煩雑な処理を意識することなく、統合ロジックに集中できます。具体的には、自然言語でアクションを検索したり、事前に構築されたアクションを実行したり、Membraneのプロキシを介してWaitlist APIに直接リクエストを送信することができます。 対応プラットフォームとしては、Claude Code、OpenClaw、Codex、Warp、WindsurfなどのAIエージェント環境を想定しています。これにより、様々なAIアシスタントが統一的にWaitlistを操作できるようになります。 主な機能として、コネクションの確立、状態監視、アクションの検索・実行、プロキシリクエストなどがあり、ベストプラクティスとして、カスタムAPIコールよりもMembraneが提供するアクションを優先することで、トークン消費の削減とセキュリティ向上が期待できます。

対応✓Claude Code✓Codex CLI~Cursor✓Windsurf
npx skills add https://github.com/membranedev/application-skills/tree/HEAD/skills/waitlist

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

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

ドキュメント

Waitlist

Waitlist は、企業が製品ローンチやイベント向けに待機リストを作成・管理できる SaaS アプリケーションです。リードを獲得し、期待感を醸成するのに役立ちます。主なユーザーはマーケティングチームとプロダクトマネージャーです。

公式ドキュメント: https://developers.waitlist.com/

Waitlist の概要

  • Waitlist
    • 参加者
    • フォーム
  • 設定

必要に応じてアクション名とパラメータを使用してください。

Waitlist の操作

このスキルは Membrane CLI を使用して Waitlist と連携します。Membrane は認証と認証情報の更新を自動的に処理するため、認証の仕組みではなく、統合ロジックに集中できます。

CLI のインストール

Membrane CLI をインストールして、ターミナルから membrane を実行できるようにします:

npm install -g @membranehq/cli@latest

認証

membrane login --tenant --clientName=<agentType>

対話モードが利用可能かどうかに応じて、認証用のブラウザが開くか、認証 URL がコンソールに表示されます。

ヘッドレス環境: コマンドは認証 URL を表示します。ユーザーにブラウザでその URL を開くように依頼してください。ログイン完了後にコードが表示されたら、次のコマンドを実行します:

membrane login complete <code>

機械可読な JSON 出力を得るには、任意のコマンドに --json を追加します。

エージェントタイプ: claude, openclaw, codex, warp, windsurf など。これらは、お使いのハーネスに最適なツールを調整するために使用されます。

Waitlist への接続

membrane connection ensure を使用して、アプリの URL またはドメインで接続を見つけるか作成します:

membrane connection ensure "http://getwaitlist.com/" --json

ユーザーはブラウザで認証を完了します。出力には新しい接続 ID が含まれます。

これが最も高速に接続を取得する方法です。URL はドメインに正規化され、既知のアプリと照合されます。アプリが見つからない場合は、新しいアプリが作成され、コネクタが自動的に構築されます。

返された接続の state が "READY" の場合は、ステップ 2 に進んでください。

1b. 接続が準備できるのを待機

接続が BUILDING 状態の場合は、準備が整うまでポーリングします:

npx @membranehq/cli connection get <id> --wait --json

--wait フラグは、状態が変化するまでロングポーリングします(--timeout 秒まで、デフォルトは 30)。state が BUILDING でなくなるまでポーリングを続けてください。

結果の状態に応じて、次に行うべきことが決まります:

  • READY — 接続は完全にセットアップされています。ステップ 2 に進んでください。

  • CLIENT_ACTION_REQUIRED — ユーザーまたはエージェントが何かを行う必要があります。clientAction オブジェクトに必要なアクションが記述されています:

    • clientAction.type — 必要なアクションの種類:
      • "connect" — ユーザーが認証する必要があります(OAuth、API キーなど)。これには、切断された接続の初回認証と再認証の両方が含まれます。
      • "provide-input" — より詳細な情報が必要です(例:どのアプリに接続するか)。
    • clientAction.description — 必要な処理を人間が読める形式で説明したもの。
    • clientAction.uiUrl (オプション) — ユーザーがアクションを完了できる事前構築済み UI の URL。存在する場合は、これをユーザーに表示します。
    • clientAction.agentInstructions (オプション) — AI エージェントがプログラムで処理を進める方法に関する指示。

    ユーザーがアクションを完了したら(例:ブラウザで認証)、再度 membrane connection get <id> --json でポーリングし、状態が READY に移行したか確認します。

  • CONFIGURATION_ERROR または SETUP_FAILED — 何か問題が発生しました。詳細は error フィールドを確認してください。

アクションの検索

実行したい操作を自然言語で記述して検索します:

membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json

特定の接続のコンテキストでアクションを検索する必要があります。

各結果には、id、name、description、inputSchema(アクションが受け入れるパラメータ)、outputSchema(返される内容)が含まれます。

よく使われるアクション

npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json を使用して、利用可能なアクションを検索してください。

アクションの実行

membrane action run <actionId> --connectionId=CONNECTION_ID --json

JSON パラメータを渡す場合:

membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json

結果はレスポンスの output フィールドに含まれます。

プロキシリクエスト

利用可能なアクションでユースケースをカバーできない場合、Membrane のプロキシを介して Waitlist API に直接リクエストを送信できます。Membrane は指定されたパスのベース URL を自動的に付加し、正しい認証ヘッダーを挿入します。認証情報が期限切れになった場合の透過的な更新も含みます。

membrane request CONNECTION_ID /path/to/endpoint

一般的なオプション:

フラグ説明
-X, --methodHTTP メソッド (GET, POST, PUT, PATCH, DELETE)。デフォルトは GET
-H, --headerリクエストヘッダーを追加 (繰り返し可能)。例: -H "Accept: application/json"
-d, --dataリクエストボディ (文字列)
--jsonJSON ボディを送信し、Content-Type: application/json を設定する shorthand
--rawDataボディをそのまま送信し、一切処理を行わない
--queryクエリ文字列パラメータ (繰り返し可能)。例: --query "limit=10"
--pathParamパスパラメータ (繰り返し可能)。例: --pathParam "id=123"

ベストプラクティス

  • 外部アプリとの通信には常に Membrane を優先する — Membrane は、組み込みの認証、ページネーション、エラーハンドリングを備えた事前構築済みアクションを提供します。これにより、トークン消費を抑え、より安全な通信が可能になります。
  • 構築する前に発見する — カスタム API コールを作成する前に、membrane action list --intent=QUERY(QUERY は目的に置き換え)を実行して既存のアクションを検索してください。事前構築済みアクションは、生の API コールでは見落とされがちなページネーション、フィールドマッピング、エッジケースを処理します。
  • Membrane に認証情報を任せる — ユーザーに API キーやトークンを要求しないでください。代わりに接続を作成してください。Membrane はサーバーサイドで認証ライフサイクル全体を管理し、ローカルに秘密情報を保持しません。

Individual skills in this repo

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

関連スキル