Bilibii MCP Server

🚀 B站粉丝数查询 MCP サービス

このサービスは、モデルコンテキストプロトコル（MCP）に基づいており、B站ユーザーのフォロワー数を照会するために使用されます。B站ユーザーIDを提供することで、そのユーザーのフォロワー数を取得することができます。

✨ 主な機能

• ユーザーIDを通じて直接B站ユーザーのフォロワー数を照会することができます。
• MCPプロトコルをサポートしており、ClaudeやGPTなどの大規模言語モデルと統合することが可能です。
• エラー処理と詳細なログ記録をサポートしています。

📦 インストール

前提条件

• Node.js v16.0.0 以上
• npm または yarn パッケージマネージャー

インストール手順

1. このリポジトリをクローンまたはダウンロードします。
2. プロジェクトディレクトリに移動し、依存関係をインストールします。

cd bilibili-mcp-server
npm install

💻 使用例

サーバーの起動

npm start

サーバーが正常に起動すると、ターミナルに以下のメッセージが表示されます。

Starting Bilibili 粉丝数 MCP サービス...
MCP サービスが接続され、実行中です！
Use Inspector で getBilibiliFollowerCount ツールにアクセスします。

MCP Inspectorを使用したテスト

1. MCP Inspectorをインストールします（未インストールの場合）。
2. InspectorをローカルのMCPサーバーに接続します。
3. getBilibiliFollowerCountツールを選択します。
4. パラメータを入力します。
   • userId: B站ユーザーの数字ID（例：184594996、163637592など）
5. "Run"をクリックして照会を実行します。

出力形式

成功時のレスポンス:

{
  "result": {
    "username": "ユーザー名",
    "followerCount": 12345
  }
}

エラー時のレスポンス:

{
  "error": "エラーメッセージ"
}

📚 ドキュメント

getBilibiliFollowerCount

B站ユーザーのフォロワー数を取得します。

パラメータ:

• userId (必須): B站ユーザーID。純粋な数字で、通常は7 - 10桁です。例："163637592"

戻り値:

• username: ユーザー名
• followerCount: フォロワー数

🔧 技術詳細

B站ユーザーIDの取得方法

B站ユーザーIDは、以下の方法で取得することができます。

1. ユーザーのスペースページにアクセスし、URLを確認します。
   • 例：https://space.bilibili.com/163637592 の 163637592 がユーザーIDです。
2. B站でユーザー名を検索し、ユーザーのスペースに移動して、URL内の数字IDを確認します。

よくある質問

Q: なぜユーザー名ではなくユーザーIDを使用する必要があるのですか？

A: B站APIはユーザーIDを通じた照会を直接サポートしており、この方法はより信頼性が高く、効率的です。ユーザー名は重複または変更される可能性がありますが、IDは一意です。

Q: APIリクエストが失敗した場合、どのように対処すればよいですか？

A: サービスは自動的に再試行し、詳細なエラーログを記録します。logsディレクトリ内のエラー詳細を確認することができます。

テストツール

このプロジェクトには、B站 API を直接テストするためのテストスクリプトが含まれています。

node test-api.js

これにより、いくつかの事前設定されたユーザーIDがテストされ、詳細なレスポンス結果が表示されます。

📄 ライセンス

MIT