xiaohongshu

小红书 MCP スキル

xiaohongshu-mcp をベースにしたシェルスクリプトツール集です。

前提条件

cd scripts/
./install-check.sh    # 检查依赖（xiaohongshu-mcp、jq、python3）
./start-mcp.sh        # 启动 MCP 服务（默认端口 18060）
./status.sh           # 确认已登录

未ログインの場合は、mcp-call.sh get_login_qrcode を実行して QR コードを取得し、小红书アプリでスキャンしてください。

サーバーのポートは MCP_URL 環境変数で変更できます（デフォルトは http://localhost:18060/mcp）。

コアデータフロー

重要： ほとんどの操作では、feed_id と xsec_token の組み合わせが必要です。この2つの値は検索／おすすめ／ユーザーホームページの結果から取得してください。自分で作成することはできません。

search_feeds / list_feeds / user_profile
        │
        ▼
  返回 feeds 数组，每个 feed 包含:
  ├── id          → 用作 feed_id
  ├── xsecToken   → 用作 xsec_token
  └── noteCard    → 标题、作者、封面、互动数据
        │
        ▼
  get_feed_detail(feed_id, xsec_token)
        │
        ▼
  返回完整笔记: 正文、图片列表、评论列表
  评论中包含 comment_id、user_id（用于回复评论）

スクリプト一覧

スクリプト	用途	パラメーター
search.sh <关键词>	ノートを検索	キーワード
recommend.sh	ホームページのおすすめ	なし
post-detail.sh <feed_id> <xsec_token>	投稿の詳細＋コメント	検索結果から取得
comment.sh <feed_id> <xsec_token> <内容>	コメントを投稿	検索結果から取得
user-profile.sh <user_id> <xsec_token>	ユーザーホームページ＋ノート	検索結果から取得
track-topic.sh <话题> [选项]	話題の分析レポート	--limit N --output file --feishu
export-long-image.sh	投稿を長画像としてエクスポート	--posts-file json -o output.jpg
mcp-call.sh <tool> [json_args]	汎用 MCP 呼び出し	下記のツール一覧を参照
start-mcp.sh	サービスを起動	--headless=false --port=N
stop-mcp.sh	サービスを停止	なし
status.sh	ログイン状態を確認	なし
install-check.sh	依存関係を確認	なし

MCP ツールの詳細パラメーター

search_feeds — ノートを検索

{"keyword": "咖啡", "filters": {"sort_by": "最新", "note_type": "图文", "publish_time": "一周内"}}

filters の任意フィールド：

• sort_by: 総合 | 最新 | いいね数が多い順 | コメント数が多い順 | お気に入り数が多い順
• note_type: 指定なし | 動画 | 画像・テキスト
• publish_time: 指定なし | 1日以内 | 1週間以内 | 半年以内
• search_scope: 指定なし | 閲覧済み | 未閲覧 | フォロー中
• location: 指定なし | 同じ都市 | 近く

get_feed_detail — 投稿の詳細

{"feed_id": "...", "xsec_token": "...", "load_all_comments": true, "limit": 20}

• load_all_comments: false（デフォルト）の場合は先頭10件を返し、true の場合はスクロールしてさらに読み込みます
• limit: 読み込むコメントの上限（load_all_comments=true の場合のみ有効）、デフォルトは 20 です
• click_more_replies: 第2階層の返信を展開するかどうか。デフォルトは false です
• reply_limit: 返信数がこの値を超えるコメントをスキップします。デフォルトは 10 です
• scroll_speed: slow | normal | fast

post_comment_to_feed — コメントを投稿

{"feed_id": "...", "xsec_token": "...", "content": "写得真好！"}

reply_comment_in_feed — コメントに返信

{"feed_id": "...", "xsec_token": "...", "content": "谢谢！", "comment_id": "...", "user_id": "..."}

comment_id と user_id は、get_feed_detail が返すコメント一覧から取得します。

user_profile — ユーザーホームページ

{"user_id": "...", "xsec_token": "..."}

user_id は feed の noteCard.user.userId から取得し、xsec_token にはその feed の xsecToken を使用します。

like_feed — いいね／取り消し

{"feed_id": "...", "xsec_token": "..."}
{"feed_id": "...", "xsec_token": "...", "unlike": true}

favorite_feed — お気に入り登録／取り消し

{"feed_id": "...", "xsec_token": "..."}
{"feed_id": "...", "xsec_token": "...", "unfavorite": true}

publish_content — 画像・テキストを投稿

{"title": "标题(≤20字)", "content": "正文(≤1000字)", "images": ["/path/to/img.jpg"], "tags": ["美食","旅行"]}

• images: 1枚以上。ローカルパスまたは HTTP URL に対応しています
• tags: 任意。話題タグ
• schedule_at: 任意。予約投稿（ISO8601、1時間後から14日以内）

publish_with_video — 動画を投稿

{"title": "标题", "content": "正文", "video": "/path/to/video.mp4"}

その他のツール

ツール	パラメーター	説明
check_login_status	なし	ログイン状態を確認
list_feeds	なし	ホームページのおすすめを取得
get_login_qrcode	なし	ログイン QR コードを取得（Base64 PNG）
delete_cookies	なし	cookies を削除して、ログイン状態をリセット

話題の追跡

自動で検索 → 詳細を取得 → Markdown レポートを生成します。

./track-topic.sh "DeepSeek" --limit 5
./track-topic.sh "春节旅游" --limit 10 --output report.md
./track-topic.sh "iPhone 16" --limit 5 --feishu    # 导出飞书

レポートには、概要統計、人気投稿の詳細（本文＋人気コメント）、コメントのキーワード、トレンド分析が含まれます。

長画像へのエクスポート

投稿を白地に黒文字の JPG 長画像としてエクスポートします。

./export-long-image.sh --posts-file posts.json -o output.jpg

posts.json の形式：

[{
  "title": "标题", "author": "作者", "stats": "1.3万赞",
  "desc": "正文摘要", "images": ["https://..."],
  "per_image_text": {"1": "第2张图的说明"}
}]

依存関係：Python 3.10+、Pillow。

注意事項

• Cookies の有効期間は約30日です。期限切れの場合は、QR コードを再度スキャンしてください
• 初回起動時に headless ブラウザーをダウンロードします（約150MB）
• 同じアカウントを複数のクライアントから同時に操作しないでください
• 投稿制限：タイトルは20文字以下、本文は1000文字以下、1日あたり50件以下
• Linux サーバーにデスクトップ環境がない場合は xvfb をインストールしてください（apt-get install xvfb。スクリプトが自動的に管理します）