Rednote MCP

🚀 小红书内容アクセスのMCPサービス

小红书の内容にアクセスするためのMCPサービスです。このサービスを使えば、小红书のノートやコメントなどの内容に簡単にアクセスできます。

  

https://github.com/user-attachments/assets/06b2c67f-d9ed-4a30-8f1d-9743f3edaa3a

🚀 クイックスタート

使用する前に、playwright環境がインストールされていることを確認してください。

npx playwright install

NPMグローバルインストール

# グローバルインストール
npm install -g rednote-mcp

# 初期化ログイン。自動的にcookieを~/.mcp/rednote/cookies.jsonファイルに記録します
rednote-mcp init

ソースコードからインストール

# プロジェクトをクローン
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp

# 依存関係をインストール
npm install

# グローバルインストール（オプション、コマンドラインからの呼び出しを便利にするため）
npm install -g .

# または直接実行、例えば初期化ログイン
npm run dev -- init

✨ 主な機能

• 認証管理（Cookieの永続化に対応）
• キーワードでノートを検索
• コマンドライン初期化ツール
• URLでノート内容にアクセス
• [ ] URLでコメント内容にアクセス（未実装）

📚 ドキュメント

1. 初期化ログイン

初めて使用する場合は、まずログインの初期化を行う必要があります。

rednote-mcp init
# またはソースコードから直接実行
npm run dev -- init
# またはmcp-clientでloginオプションを選択

このコマンドを実行すると：

1. 自動的にブラウザウィンドウが開きます
2. 小红书のログインページに遷移します
3. 手動でログイン操作を完了してください
4. ログインに成功すると、Cookieが自動的に~/.mcp/rednote/cookies.jsonファイルに保存されます

2. CursorでMCP Serverを設定

Cursorのsettings.jsonに以下の設定を追加してください。

{
  "mcpServers": {
    "RedNote MCP": {
      "command": "rednote-mcp",
      "args": [
        "--stdio"
      ]
    }
  }
}

またはnpx方式を使用する場合は：

{
  "mcpServers": {
    "RedNote MCP": {
      "command": "npx",
      "args": [
        "rednote-mcp",
        "--stdio"
      ]
    }
  }
}

設定説明：

• command：グローバルインストール後のrednote-mcpコマンド、またはnpxで直接実行することができます
• args：Cursorの通信方式をサポートするために、--stdioパラメータを含める必要があります

🔧 技術詳細

環境要件

• Node.js >= 16
• npm >= 7

開発フロー

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

# 開発サーバーを起動
npm start

⚠️ 注意事項

• 使用中は、小红书の関連規定や法令を遵守してください
• 初期化ログイン時には、ネットワークが正常に接続されており、ブラウザがJavaScriptをサポートしていることを確認してください
• 問題が発生した場合は、Cookieが有効かどうか、およびネットワーク接続が正常かどうかを確認してください

🤝 貢献ガイド

• バグ修正や新機能の追加のためのPull Requestの送信を歓迎します
• 具体的な貢献フローについては、プロジェクト内のCONTRIBUTING.mdファイルを読んでから進めてください
• 質問がある場合は、Issuesで議論することができます