mcpField
A
api-integration

api-integration

github.com/meta開発1847 回インストール5 日前に更新
リポジトリ

api-integration について

api-integrationは、WhatsApp、Instagram、MessengerなどのMeta API連携を準備する開発者向けスキルです。devtoolsでドキュメントを調査し、アプリの状態を確認して、認証、権限、エンドポイント、コード例をまとめたガイドを作成します。

主な機能

  1. 01製品ドキュメントとコード例の検索
  2. 02アプリ設定と権限状態の確認
  3. 03認証と権限要件の整理
  4. 04エンドポイントとコード例の案内
  5. 05次の手順の提案

活用シーン

  1. 01WhatsApp Business API連携の計画
  2. 02Instagram Graph API投稿の準備
  3. 03Metaアプリの権限と審査要件の確認
  4. 04Webhook連携のセットアップ手順の整理

MCP 対応

Meta Social Technologiesのdevtools MCPサーバー（https://mcp.facebook.com/devtools）が必要です。ツールを使ってドキュメント検索、アプリと権限の確認、スキル呼び出しの記録を行います。

インストール

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

$npx skills add https://github.com/meta/agentic-tools --skill api-integration

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

詳細

API 統合

「X と統合したい」という段階から、コードを書き始めるために必要なものがすべてそろった状態まで、開発者を支援します。

前提条件 — MCP 接続（最初にお読みください）

このスキルには、Meta Social Technologies MCP サーバー devtools（https://mcp.facebook.com/devtools、streamable-http）が必要です。プラグインのインストールには含まれていますが、npx skills add などのスキルのみのインストールには含まれていません（セットアップ）。

mcp__devtools__* ツールを利用できない場合は、ここで停止してください。 手順 1 のトラッキング呼び出しを含め、ツールの出力を捏造してはいけません。サーバーを追加し、OAuth フローを完了するようユーザーに依頼してください（アクセストークンを求めてはいけません）。その後、続行してください。

ワークフロー

  1. トラッキングを開始します。 ほかの作業を始める前に、action start、skill_name api-integration を指定して devtools_skill_invocation を呼び出します。以下の手順で devtools_* ツールを呼び出すたびに、skill_name api-integration を渡してください。

  2. 統合対象を特定します。 何を構築したいのかが明確でない場合は、ユーザーに確認します。一般的な統合対象は次のとおりです。

    • WhatsApp Business API（メッセージの送受信、テンプレート、メディア）
    • Instagram Graph API（コンテンツの公開、インサイトの閲覧、コメントの管理）
    • Messenger Platform（チャットボット、Send API、ウェブフック）
    • Pages API（コンテンツの投稿、インサイトの閲覧、ページの管理）
    • Marketing API（キャンペーンの作成、広告の管理、分析データの閲覧）
    • Facebook ログイン／Instagram ログイン
    • Facebook Login for Business

  3. 統合対象を調査します。 全体像を把握するため、複数の検索を実行します。検索は 1 回で終わらせず、クエリを重ねてあらゆる側面を網羅してください。

    検索 1 — 概要と利用開始：

    • devtools_discovery → search_docs を使い、製品名に「getting started」または「overview」を加えて検索します
    • 例：「WhatsApp Business API getting started」

    検索 2 — 認証とアクセストークン：

    • devtools_discovery → search_docs を使い、認証要件を検索します
    • 例：「WhatsApp Business API access token authentication」

    検索 3 — 必要な権限とアプリレビュー：

    • devtools_discovery → search_docs を使い、権限を検索します
    • 例：「WhatsApp Business API permissions」
    • app_id が指定されている場合は、アプリも確認します：devtools_app_review → requirements と privileges

    検索 4 — 主要な API エンドポイント：

    • devtools_discovery → search_docs を使い、ユーザーが必要とする具体的な操作を検索します
    • 例：「WhatsApp send message API」または「Instagram publish media API」

    検索 5 — ウェブフック（該当する場合）：

    • devtools_discovery → search_docs を使い、ウェブフックの設定を検索します
    • 例：「WhatsApp webhooks setup」

    検索 6 — レート制限とクォータ：

    • devtools_discovery → search_docs を使い、製品固有のレート制限とスループットの段階を検索します
    • 例：「WhatsApp Business API rate limits messaging tiers」または「Instagram API rate limits」

    検索 7 — コード例と SDK：

    • devtools_discovery → search_docs を使い、SDK、クライアントライブラリ、またはコードサンプルを検索します
    • まず製品固有のクエリを試します：「WhatsApp Business Platform Node.js」または「Instagram Graph API Python」
    • SDK の検索結果がない場合は、「Graph API client library」または製品のクイックスタートガイドを検索します
    • 最後の手段として、検索 4 のエンドポイントドキュメントをもとに例を作成します

    検索 1～5 は速度を優先して並行して実行します。必要に応じて、その後に検索 6～7 を実行します。包括的な結果を得るために、max_results を 10 に設定し、offset を使ってページネーションします。最初の結果の範囲が広すぎる場合や、重要なトピックが含まれていない場合は、クエリを調整してください。

  4. アプリの準備状況を確認します（ユーザーがアプリを所有している場合）。

    • アプリを名前で指定した場合（または ID が分からない場合）は、まず devtools_app_list（action list）を使って app_id を特定します。候補が複数ある場合は、候補（名前、ID、閲覧者のロール）を提示して選択を依頼します
    • devtools_app → basic_settings を使い、アプリの種類とステータスを確認します
    • devtools_app_review → privileges を使い、すでに承認されている項目を確認します
    • devtools_app_review → requirements を使い、必要な項目を確認します

  5. 統合ガイドを作成します。 検索結果から重要な情報を抽出し、生の検索結果をそのまま出力しないでください。調査結果を、実行に移せるドキュメントとして整理します。

    ガイドの形式

    概要

    • API の機能と、この API でユーザーが構築できるもの
    • 公式製品ドキュメントへのリンク

    前提条件

    • Meta Developer アカウント
    • 必要なアプリの種類（Business、Consumer など）
    • 製品固有の前提条件（WhatsApp Business Account、Facebook Page など）

    認証

    • 必要なトークンの種類（User、Page、System User など）
    • トークンの生成方法
    • 必要なトークン権限／スコープ
    • トークンの有効期限と更新フロー

    必要な権限

    • 必要な各権限と、その権限で許可される操作
    • App Review が必要な権限と、自動承認される権限
    • app_id が指定されている場合：すでに付与されている権限と、今後必要な権限

    セットアップ手順

    • 最初の API 呼び出しまでの手順をゼロから順に説明します
    • 統合に必要な場合は、Webhook のセットアップも含めます

    主な API エンドポイント

    • 各エンドポイントについて、メソッド、URL パターン、主なパラメーター、レスポンス例を記載します
    • 網羅的な一覧ではなく、ユーザーの依頼内容に焦点を当てます

    コード例

    • ユーザーが希望する言語で、動作する基本的なサンプルを示します
    • 認証、基本的な API 呼び出し、エラー処理を含めます
    • 公式 SDK がある場合はそれを使用し、ない場合は生の HTTP（curl/fetch）を使用します
    • 統合が Webhook ベースの場合は、Webhook ハンドラーのコードも含めます

    レート制限とクォータ

    • 製品固有のレート制限とスループットの段階（例：WhatsApp のメッセージ送信ティア：1K/10K/100K/無制限）
    • 該当する場合は、エンドポイントごとのレート制限
    • 継続的な監視には /api-health を提案します

    よくある落とし穴

    • ドキュメントに記載された製品固有の注意点
    • 権限の誤り、トークンの種類の混同、Webhook の検証に関する問題

  6. 次のステップを提案します：

    • 権限に App Review が必要な場合は /app-review-prep
    • 統合で Webhook を使用する場合は /webhook-setup
    • 本番稼働後の使用状況の監視には /api-health

  7. トラッキングを終了します。 上記のすべての手順が完了したら、action を end、skill_name を api-integration として devtools_skill_invocation を呼び出します。

ヒント

  • クエリを変えて、必ず複数回検索してください。1 回の検索だけでは、認証、権限、エンドポイント、使用例の情報が揃わないことがほとんどです。
  • コード例では、ユーザーが指定した言語／フレームワークを優先します。指定がない場合は、Node.js/JavaScript を使用します。
  • ユーザーが app_id を提示している場合は、現在の権限と統合に必要な権限を照合してください。これにより、ユーザーの手間を省けます。
  • WhatsApp や Instagram などの統合には Business タイプのアプリが必要な場合があります。ユーザーのアプリの種類が適切でなければ、早い段階で指摘してください。
  • Messenger や WhatsApp など、Webhook ベースの統合はコールバック URL がなければ動作しません。先回りして /webhook-setup を提案してください。

コメント

Markdown 対応