Rednote MCP

🚀 RedNote 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 サーバを設定

Cursor の settings.json ファイルに以下の設定を追加します。

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

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

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

🔧 技術詳細

環境要件

• Node.js と npm がインストールされていること
• playwright をインストール：npx playwright install

開発フロー

# プロジェクトをクローンしてディレクトリに移動
git clone https://github.com/ifuryst/rednote-mcp.git
cd rednote-mcp

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

# 開発バージョンを実行
npm run dev

デバッグツール

playwright が提供するデバッグツールを使用してデバッグします。

npx playwright

📄 ライセンス

[ここに具体的なライセンス内容（MITやApacheなど）を記載する必要があります]

⚠️ 重要提示

• 初回使用時は、初期化コマンド rednote-mcp init を実行してください。
• Cookieのセキュリティに注意してください。~/.mcp/rednote/cookies.json ファイルを適切に保管し、漏洩を防いでください。

💡 使用建议

コードリポジトリは https://github.com/ifuryst/rednote-mcp です。Fork や Pull Request を歓迎します。何か問題があれば、Issues に投稿してください。