小红书

小红书 MCP

本 技能 是一个薄的 Python 客户端，通过 HTTP 调用用户自行独立安装、启动并保管的第三方本地组件 xpzouying/xiaohongshu-mcp。本 技能 不分发、不捆绑、不自动拉取任何第三方二进制。首次安装请参阅 设置UP.md。

客户端侧自动护栏（客户端拒绝执行的条件）

以下检查由 scripts/xhs_命令行工具ent.py 自动执行，任何一项不满足都会直接拒绝发起调用：

检查 触发条件 客户端行为 Loopback 端点 目标地址不解析到 127.0.0.1/localhost/::1 进程启动即拒绝（退出码 1） 非交互发布 stdin 非 TTY 且未传 --yes 拒绝 publish，返回 error 交互发布确认 TTY 下用户未输入 PUBLISH 字面量 取消 publish 专用账号声明 XHS_DEDICATED_ACCOUNT 未显式置 yes 拒绝 publish 上游版本可见性 XHS_UP流_PINNED_VERSION 未设置 状态 输出中性提醒

这些不是建议，是运行时机械拒绝。用户或代理无需依赖额外自律。

快速参考 python scripts/xhs_命令行工具ent.py 状态 python scripts/xhs_命令行工具ent.py 搜索 "美食推荐" python scripts/xhs_命令行工具ent.py 搜索 "美食" --排序 "最多点赞" --type "图文" --time "一周内" python scripts/xhs_命令行工具ent.py detAIl --comments python scripts/xhs_命令行工具ent.py feeds python scripts/xhs_命令行工具ent.py publish "标题" "正文" "图1,图2" --tags "标签1,标签2"

所有命令支持 --json 输出原始 JSON。

工作流：市场调研（只读） 进度：

• [ ] 第 1 步：验证连接
• [ ] 第 2 步：搜索关键词
• [ ] 第 3 步：获取笔记详情
• [ ] 第 4 步：分析结果

第 1 步

python scripts/xhs_命令行工具ent.py 状态

第 2 步

python scripts/xhs_命令行工具ent.py 搜索 "户外电源" --排序 "最多点赞" --json

筛选：--排序（综合/最新/最多点赞/最多评论/最多收藏）、--type（不限/视频/图文）、--time（不限/一天内/一周内/半年内）。

第 3 步

python scripts/xhs_命令行工具ent.py detAIl "" "" --comments --json

第 4 步

查看笔记内容、互动数据（点赞、收藏、评论）与评论情感倾向。

工作流：发布内容 进度：

• [ ] 第 1 步：验证连接
• [ ] 第 2 步：准备素材
• [ ] 第 3 步：向用户展示预览并获取逐次授权
• [ ] 第 4 步：发起发布（受客户端护栏保护）
• [ ] 第 5 步：验证上线

第 1 步

python scripts/xhs_命令行工具ent.py 状态

第 2 步

准备标题（建议 ≤ 20 字）、正文、可公开访问的图片 URL、可选标签。

第 3 步 — 代理必须执行的强制预览

调用 publish 前，代理必须向用户打印结构化预览并等待用户在对话中回复明确授权词：

📋 发布预览 ──────────── 账号：<状态 返回的账号> 标题：