Audiense MCP ServerによるTweetBinder

これはTweetBinder by Audiense API 用のモデル コンテキスト プロトコル (MCP)サーバーであり、 Claudeやその他の MCP 互換 AI モデルが TweetBinder by Audiense 分析データにアクセスできるようにします。

特徴

• Claudeから直接TweetBinderの分析にアクセス
• Twitter/Xのハッシュタグ、ユーザー、会話を分析する
• エンゲージメント指標、感情分析などを取得
• カスタム検索クエリでTwitterレポートを作成する
• レポート生成ステータスを確認する
• 詳細なレポート統計を取得する
• アカウント残高と割り当て情報を取得する
• 特定のクエリに一致するツイートをカウントする
• TweetBinderレポートの一覧表示と管理
• レポートからツイートの内容とユーザー情報にアクセスする

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の mcp-tweetbinder を自動的にインストールするには:

手動設定

前提条件

• Node.js (v18以上)
• クロードデスクトップアプリ
• API 認証情報を持つTweetBinder by Audienseアカウント

1. このリポジトリをクローンする
2. 依存関係をインストールします:
   npm install
3. プロジェクトをビルドします。
   npm run build

このサービスを利用するには、有効なTweetBinder APIベアラートークンが必要です。環境に合わせて設定してください。

Claude Desktopでの使用

1. Claude Desktop 構成ファイルを編集します。
   • MacOSの場合:
     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • ウィンドウズ:
     code %AppData%\Claude\claude_desktop_config.json
2. 次の構成を追加します。

3. Claudeデスクトップを再起動します

利用可能なツール

create-twitter-report

検索クエリに基づいて Twitter/X データを分析する新しいレポートを作成します。

• パラメータ:
  • query (文字列): Twitterデータの検索クエリ。AND、OR、ハッシュタグ、メンションなどの演算子を含めることができます。
  • limit (数値、オプション): 取得するツイートの最大数 (最大 50,000)。
  • startDate (数値、オプション): Unix タイムスタンプとしての開始日 (エポックからの秒数)。
  • endDate (数値、オプション): Unix タイムスタンプとしての終了日 (エポックからの秒数)。
  • reportType (列挙型、オプション): 作成するレポートの種類。「7-day」（過去1週間）または「historical」（全期間）。デフォルト: 「7-day」。
• 応答：
  • 作成されたレポートのレポート ID とステータス情報。
  • レポートのステータスを確認し、統計を取得するための手順。

create-twitter-count

検索クエリに一致するツイートをカウントする新しいレポートを作成します。

• パラメータ:
  • query (文字列): Twitterデータの検索クエリ。AND、OR、ハッシュタグ、メンションなどの演算子を含めることができます。
  • reportType (列挙型、オプション): 作成するレポートの種類。「7-day」（過去1週間）または「historical」（全期間）。デフォルト: 「7-day」。
• 応答：
  • 以下を含む生の JSON 応答:
    • status : レポート作成のステータス
    • resourceId : 作成されたレポートのID
    • error / message : エラーまたはステータスメッセージ

list-reports

並べ替え機能を備えたすべての TweetBinder レポートのリストを取得します。

• パラメータ:
  • order (文字列、オプション): 'field|direction' 形式のソートパラメータ。例: 'createdAt|-1' は新しい順、'createdAt|1' は古い順。
• 応答：
  • それぞれの詳細を含むレポートの配列を含む生の JSON 応答:
    • id : レポートID
    • name : レポート名
    • status : 現在のステータス (生成済み、待機中など)
    • createdAt : 作成タイムスタンプ
    • updatedAt : 最終更新日時
    • type : レポートタイプ
    • source : レポート元
    • query : 元の検索クエリ

get-report-content

高度なフィルタリングとページ区切りを使用して、生成されたレポートから実際のツイートまたはユーザーを取得します。

• パラメータ:
  • reportId (文字列): コンテンツを取得するレポートの ID。
  • contentType (列挙型): 取得するコンテンツのタイプ: ツイート データの場合は「tweets」、ユーザー データの場合は「users」。
  • page (数値、オプション): ページ番号。1から始まります。
  • perPage (数値、オプション): ページあたりの項目数。
  • sortBy (文字列、オプション): 並べ替えの基準となるフィールド (例: 'createdAt'、'counts.favorites')。
  • sortDirection (列挙型、オプション): 並べ替えの方向: 昇順の場合は '1'、降順の場合は '-1'。
  • filter （文字列、オプション）: フィルター条件を含むJSON文字列。例: '{"counts.favorites":{"$gt":10}}'
• 応答：
  • 以下を含む生の JSON 応答:
    • items : ツイートまたはユーザーオブジェクトの配列
    • pagination : 合計アイテム数とページ数に関する情報

  ツイートをリクエストすると、次のような詳細情報が返されます。

  • ツイートID、テキスト、作成日、言語
  • 著者の詳細（名前、ユーザー名、フォロワーなど）
  • エンゲージメント指標（リツイート、いいね、返信など）
  • メディアコンテンツ（ハッシュタグ、画像、リンク）
  • 感情分析

  ユーザーにリクエストする場合、次の情報が含まれます。

  • ユーザーID、名前、ユーザー名
  • プロフィール写真のURL
  • フォロワーとフォロー数
  • 検証ステータス
  • ユーザー価値とその他の指標

**注:**コンテンツにアクセスするには、レポートのステータスが「生成済み」である必要があります。レポートの準備ができているかどうかを確認するにはget-report-statusツールをご利用ください。

クエリ構文の例:

• #apple : ハッシュタグ #apple を含むツイート
• apple lang:en : 「apple」を含む英語のツイート
• (#apple OR #iphone) -#android : #apple または #iphone を含むが #android を含まないツイート
• @apple : @apple をメンションしたツイート
• from:apple : ユーザー「apple」が投稿したツイート

**注:**カウント レポートを作成した後、 get-report-statusツールを使用して準備が完了したかどうかを確認し、 get-report-statsを使用して実際のカウントを取得します。

get-report-status

TweetBinder レポートの現在のステータスを確認します。

• パラメータ:
  • reportId (文字列): 確認するレポートの ID。
• 応答：
  • レポートの現在のステータス。次のいずれかになります。
    • 生成済み: レポートが完了し、使用できる状態になりました。
    • 待機中: レポートはまだ生成中、またはツイートの収集を待機中です。
    • 古いもの: レポートは新しいデータで更新されており、まもなく利用可能になります。
    • 削除済み: レポートは削除されており、利用できなくなりました。
    • アーカイブ済み: レポートはアーカイブされており、すぐに削除される可能性があります。
  • ステータスの意味と実行可能なアクションの説明。

**注:**レポート ID を取得するには、まずcreate-twitter-reportまたはcreate-twitter-countツールを使用してレポートを作成する必要があります。

get-report-stats

TweetBinder レポートの包括的な統計と分析を取得します。

• パラメータ:
  • reportId (文字列): 統計情報を取得するレポートの ID。
• 応答：
  • 次の項目を含むレポート統計のフォーマットされた要約:
    • 概要: ツイートの合計数、日付範囲、投稿者、エンゲージメント、メディア、リンク。
    • エンゲージメント指標: 潜在的なリーチ、インプレッション、リツイート、いいね。
    • 感情分析: 全体的な感情スコアと解釈。
    • トップ貢献者: 最もアクティブなユーザーとそのツイート数。
    • 人気コンテンツ: 最もリツイートされた投稿。
    • よく使用されるハッシュタグ: 会話でよく使用されるハッシュタグ。

**注:**統計情報を取得するには、レポートのステータスが「生成済み」になっている必要があります。レポートの準備ができているかどうかを確認するにはget-report-statusツールを使用してください。

get-account-balances

アカウントのクレジット残高、使用状況、残りのクォータに関する情報を取得します。

• パラメータ:
  • なし
• 戻り値:
  • 以下を含む生の JSON 応答:
    • total ：利用可能なクレジットの合計
    • used ：使用されたクレジット
    • available ：現在利用可能なクレジット
    • discount : 適用可能な割引
    • remainingReports : 残りのレポート数
    • quota : 以下のクォータ情報が含まれます:
      • startedAt : クォータ期間の開始日
      • finishedAt : クォータ期間の終了日
      • remaining ：残りの割り当て
      • used ：使用済み割り当て
      • total : 合計割り当て
  • エラーまたはステータスメッセージ

トラブルシューティング

Claudeにツールが表示されない

1. Claude Desktop のログを確認します。

2. 環境変数が正しく設定されていることを確認します。
3. index.js への絶対パスが正しいことを確認してください。

認証の問題

• 資格情報を再確認してください。
• リフレッシュ トークンがまだ有効であることを確認します。
• 必要な API スコープが有効になっていることと、十分なクレジットがあることを確認します。

ログの表示

サーバー ログを確認するには:

MacOS/Linuxの場合:

Windowsの場合:

セキュリティに関する考慮事項

• API 認証情報は安全に保ち、パブリック リポジトリに公開しないでください。
• 環境変数を使用して機密データを管理します。

📄 ライセンス

このプロジェクトはApache 2.0ライセンスに基づいてライセンスされています。詳細についてはLICENSEファイルをご覧ください。