{
  "schemaVersion": "1.0",
  "item": {
    "slug": "post2xhs",
    "name": "post-to-xhs",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/luweizheng/post2xhs",
    "canonicalUrl": "https://clawhub.ai/luweizheng/post2xhs",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/post2xhs",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=post2xhs",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/post2xhs"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/post2xhs",
    "agentPageUrl": "https://openagent3.xyz/skills/post2xhs/agent",
    "manifestUrl": "https://openagent3.xyz/skills/post2xhs/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/post2xhs/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "安装",
        "body": "首次使用需要确认环境中有 Python 解释器。\n\n# 使用 pip 安装\npip install -U xhs-mcp-py\n\n# 安装 Playwright 浏览器（必需）\nplaywright install chromium"
      },
      {
        "title": "⚠️ 重要：所有操作必须先登录",
        "body": "小红书所有功能（发布、搜索、点赞、评论等）都需要先登录。"
      },
      {
        "title": "1. 检查登录状态",
        "body": "执行任何操作前，先检查是否已登录：\n\nxhs-mcp status\n\n输出 ✅ 已登录：可以继续操作\n输出 ❌ 未登录：必须先执行登录步骤"
      },
      {
        "title": "2. 登录方式（带 fallback 逻辑）",
        "body": "推荐按以下顺序尝试登录：\n\n方式一：终端二维码（Claude Code / Open Code 推荐）\n\nxhs-mcp login-qrcode --terminal\n\n⚠️ 需要安装 zbar 库才能解析二维码：\n\nmacOS: brew install zbar\nUbuntu: apt install libzbar0\n\n\n如果未安装 zbar，会自动保存二维码图片并提示路径\n用户扫码后按回车完成登录\n如果终端显示失败，fallback 到方式二\n\n方式二：浏览器扫码登录（有图形界面的环境）\n\nxhs-mcp login-browser\n\n会弹出浏览器窗口供用户扫码\n如果无法弹出浏览器（如远程服务器无图形界面），会提示使用二维码方式\n\n方式三：保存二维码图片（OpenClaw 推荐）\n\nxhs-mcp login-qrcode --save /tmp/qrcode.png\n\n将二维码图片发送给用户扫码\n用户扫码后按回车完成登录\n\n如果以上方式都失败：\n\n提醒用户需要安装浏览器环境（Playwright + Chromium）\n或需要图形界面环境"
      },
      {
        "title": "3. 登录参数说明",
        "body": "login-qrcode 参数：\n\n参数类型必需说明-s/--savestring❌保存二维码图片到指定路径--terminal/--no-terminalflag❌是否在终端显示二维码（默认 terminal）\n\n登录成功后，cookies 会保存到本地文件，后续操作自动复用（有效期约 7-30 天）。"
      },
      {
        "title": "发布图文内容",
        "body": "命令：xhs-mcp publish\n\n参数：（-i/--image、--tag 可多次指定）\n\n参数类型必需说明-t/--titlestring✅文字标题-c/--contentstring✅文字正文内容-i/--imagestring✅图片路径（可多次指定）--tagstring❌话题标签（可多次指定）--headless/--no-headlessflag❌是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp publish -t \"标题\" -c \"正文\" -i /abs/1.jpg -i /abs/2.jpg --tag 旅行 --tag 美食"
      },
      {
        "title": "发布视频内容",
        "body": "命令：xhs-mcp publish-video\n\n参数：\n\n参数类型必需说明-t/--titlestring✅文字标题-c/--contentstring✅文字正文内容-v/--videostring✅视频路径--tagstring❌话题标签（可多次指定）--headless/--no-headlessflag❌是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp publish-video -t \"标题\" -c \"正文\" -v /abs/video.mp4"
      },
      {
        "title": "发布文字配图（文字卡片）",
        "body": "命令：xhs-mcp publish-text-card\n\n参数：（-p/--page、--tag 可多次指定）\n\n参数类型必需说明-c/--coverstring✅封面文字-p/--pagestring❌正文页文字（可多次指定，最多17页）-s/--stylestring❌卡片样式：基础|边框|备忘|手写|便签|涂写|简约|光影|几何-t/--titlestring❌文字标题--contentstring❌文字正文内容--tagstring❌话题标签（可多次指定）--headless/--no-headlessflag❌是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp publish-text-card -c \"封面\" -p \"第一页\" -p \"第二页\" -s \"基础\" -t \"笔记标题\""
      },
      {
        "title": "搜索内容",
        "body": "命令：xhs-mcp search\n\n参数：\n\n参数类型必需说明-k/--keywordstring✅搜索关键词--headless/--no-headlessflag❌是否无头模式（默认 headless）\n\n输出：\n\n命令会打印搜索到的笔记列表。每条结果会包含：\n\nID：对应后续命令里的 --feed-id\nxsec_token：对应后续命令里的 --xsec-token\n\n示例（截断）：\n\n1. 标题...\n   作者: xxx | 点赞: 123\n   ID: 1234567890abcdef\n   xsec_token: xsec_xxx"
      },
      {
        "title": "互动（点赞/收藏/评论）",
        "body": "以下命令需要你先从搜索结果或笔记链接中拿到 feed_id 和 xsec_token。"
      },
      {
        "title": "点赞/取消点赞",
        "body": "命令：xhs-mcp like\n\n参数：\n\n参数类型必需说明--feed-idstring✅笔记 ID--xsec-tokenstring✅访问令牌--unlikeflag❌取消点赞（默认 false 为点赞）--headless/--no-headlessflag❌是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp like --feed-id FEED_ID --xsec-token XSEC_TOKEN\nxhs-mcp like --feed-id FEED_ID --xsec-token XSEC_TOKEN --unlike"
      },
      {
        "title": "收藏/取消收藏",
        "body": "命令：xhs-mcp favorite\n\n参数：\n\n参数类型必需说明--feed-idstring✅笔记 ID--xsec-tokenstring✅访问令牌--unfavoriteflag❌取消收藏（默认 false 为收藏）--headless/--no-headlessflag❌是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp favorite --feed-id FEED_ID --xsec-token XSEC_TOKEN\nxhs-mcp favorite --feed-id FEED_ID --xsec-token XSEC_TOKEN --unfavorite"
      },
      {
        "title": "发表评论",
        "body": "命令：xhs-mcp comment\n\n参数：\n\n参数类型必需说明--feed-idstring✅笔记 ID--xsec-tokenstring✅访问令牌-c/--contentstring✅评论内容--headless/--no-headlessflag❌是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp comment --feed-id FEED_ID --xsec-token XSEC_TOKEN -c \"评论内容\""
      },
      {
        "title": "回复评论",
        "body": "命令：xhs-mcp reply-comment\n\n参数：\n\n参数类型必需说明--feed-idstring✅笔记 ID--xsec-tokenstring✅访问令牌-c/--contentstring✅回复内容--comment-idstring❌目标评论 ID--user-idstring❌目标用户 ID--headless/--no-headlessflag❌是否无头模式（默认 headless）\n\n--comment-id 和 --user-id 至少需要提供一个。\n\n示例：\n\nxhs-mcp reply-comment --feed-id FEED_ID --xsec-token XSEC_TOKEN -c \"回复内容\" --comment-id COMMENT_ID"
      },
      {
        "title": "退出登录",
        "body": "命令：xhs-mcp logout\n\n会删除本地 cookies。"
      },
      {
        "title": "（可选）MCP 模式",
        "body": "如果你的运行环境支持 MCP（例如 Claude Desktop / Cursor），可以启动 MCP：\n\nxhs-mcp serve"
      }
    ],
    "body": "xhs-mcp-py 使用方式\n安装\n\n首次使用需要确认环境中有 Python 解释器。\n\n# 使用 pip 安装\npip install -U xhs-mcp-py\n\n# 安装 Playwright 浏览器（必需）\nplaywright install chromium\n\n⚠️ 重要：所有操作必须先登录\n\n小红书所有功能（发布、搜索、点赞、评论等）都需要先登录。\n\n1. 检查登录状态\n\n执行任何操作前，先检查是否已登录：\n\nxhs-mcp status\n\n输出 ✅ 已登录：可以继续操作\n输出 ❌ 未登录：必须先执行登录步骤\n2. 登录方式（带 fallback 逻辑）\n\n推荐按以下顺序尝试登录：\n\n方式一：终端二维码（Claude Code / Open Code 推荐）\n\nxhs-mcp login-qrcode --terminal\n\n⚠️ 需要安装 zbar 库才能解析二维码：\nmacOS: brew install zbar\nUbuntu: apt install libzbar0\n如果未安装 zbar，会自动保存二维码图片并提示路径\n用户扫码后按回车完成登录\n如果终端显示失败，fallback 到方式二\n\n方式二：浏览器扫码登录（有图形界面的环境）\n\nxhs-mcp login-browser\n\n会弹出浏览器窗口供用户扫码\n如果无法弹出浏览器（如远程服务器无图形界面），会提示使用二维码方式\n\n方式三：保存二维码图片（OpenClaw 推荐）\n\nxhs-mcp login-qrcode --save /tmp/qrcode.png\n\n将二维码图片发送给用户扫码\n用户扫码后按回车完成登录\n\n如果以上方式都失败：\n\n提醒用户需要安装浏览器环境（Playwright + Chromium）\n或需要图形界面环境\n3. 登录参数说明\n\nlogin-qrcode 参数：\n\n参数\t类型\t必需\t说明\n-s/--save\tstring\t❌\t保存二维码图片到指定路径\n--terminal/--no-terminal\tflag\t❌\t是否在终端显示二维码（默认 terminal）\n\n登录成功后，cookies 会保存到本地文件，后续操作自动复用（有效期约 7-30 天）。\n\n发布操作\n发布图文内容\n\n命令：xhs-mcp publish\n\n参数：（-i/--image、--tag 可多次指定）\n\n参数\t类型\t必需\t说明\n-t/--title\tstring\t✅\t文字标题\n-c/--content\tstring\t✅\t文字正文内容\n-i/--image\tstring\t✅\t图片路径（可多次指定）\n--tag\tstring\t❌\t话题标签（可多次指定）\n--headless/--no-headless\tflag\t❌\t是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp publish -t \"标题\" -c \"正文\" -i /abs/1.jpg -i /abs/2.jpg --tag 旅行 --tag 美食\n\n发布视频内容\n\n命令：xhs-mcp publish-video\n\n参数：\n\n参数\t类型\t必需\t说明\n-t/--title\tstring\t✅\t文字标题\n-c/--content\tstring\t✅\t文字正文内容\n-v/--video\tstring\t✅\t视频路径\n--tag\tstring\t❌\t话题标签（可多次指定）\n--headless/--no-headless\tflag\t❌\t是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp publish-video -t \"标题\" -c \"正文\" -v /abs/video.mp4\n\n发布文字配图（文字卡片）\n\n命令：xhs-mcp publish-text-card\n\n参数：（-p/--page、--tag 可多次指定）\n\n参数\t类型\t必需\t说明\n-c/--cover\tstring\t✅\t封面文字\n-p/--page\tstring\t❌\t正文页文字（可多次指定，最多17页）\n-s/--style\tstring\t❌\t卡片样式：基础|边框|备忘|手写|便签|涂写|简约|光影|几何\n-t/--title\tstring\t❌\t文字标题\n--content\tstring\t❌\t文字正文内容\n--tag\tstring\t❌\t话题标签（可多次指定）\n--headless/--no-headless\tflag\t❌\t是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp publish-text-card -c \"封面\" -p \"第一页\" -p \"第二页\" -s \"基础\" -t \"笔记标题\"\n\n浏览/搜索\n搜索内容\n\n命令：xhs-mcp search\n\n参数：\n\n参数\t类型\t必需\t说明\n-k/--keyword\tstring\t✅\t搜索关键词\n--headless/--no-headless\tflag\t❌\t是否无头模式（默认 headless）\n\n输出：\n\n命令会打印搜索到的笔记列表。每条结果会包含：\n\nID：对应后续命令里的 --feed-id\nxsec_token：对应后续命令里的 --xsec-token\n\n示例（截断）：\n\n1. 标题...\n   作者: xxx | 点赞: 123\n   ID: 1234567890abcdef\n   xsec_token: xsec_xxx\n\n互动（点赞/收藏/评论）\n\n以下命令需要你先从搜索结果或笔记链接中拿到 feed_id 和 xsec_token。\n\n点赞/取消点赞\n\n命令：xhs-mcp like\n\n参数：\n\n参数\t类型\t必需\t说明\n--feed-id\tstring\t✅\t笔记 ID\n--xsec-token\tstring\t✅\t访问令牌\n--unlike\tflag\t❌\t取消点赞（默认 false 为点赞）\n--headless/--no-headless\tflag\t❌\t是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp like --feed-id FEED_ID --xsec-token XSEC_TOKEN\nxhs-mcp like --feed-id FEED_ID --xsec-token XSEC_TOKEN --unlike\n\n收藏/取消收藏\n\n命令：xhs-mcp favorite\n\n参数：\n\n参数\t类型\t必需\t说明\n--feed-id\tstring\t✅\t笔记 ID\n--xsec-token\tstring\t✅\t访问令牌\n--unfavorite\tflag\t❌\t取消收藏（默认 false 为收藏）\n--headless/--no-headless\tflag\t❌\t是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp favorite --feed-id FEED_ID --xsec-token XSEC_TOKEN\nxhs-mcp favorite --feed-id FEED_ID --xsec-token XSEC_TOKEN --unfavorite\n\n发表评论\n\n命令：xhs-mcp comment\n\n参数：\n\n参数\t类型\t必需\t说明\n--feed-id\tstring\t✅\t笔记 ID\n--xsec-token\tstring\t✅\t访问令牌\n-c/--content\tstring\t✅\t评论内容\n--headless/--no-headless\tflag\t❌\t是否无头模式（默认 headless）\n\n示例：\n\nxhs-mcp comment --feed-id FEED_ID --xsec-token XSEC_TOKEN -c \"评论内容\"\n\n回复评论\n\n命令：xhs-mcp reply-comment\n\n参数：\n\n参数\t类型\t必需\t说明\n--feed-id\tstring\t✅\t笔记 ID\n--xsec-token\tstring\t✅\t访问令牌\n-c/--content\tstring\t✅\t回复内容\n--comment-id\tstring\t❌\t目标评论 ID\n--user-id\tstring\t❌\t目标用户 ID\n--headless/--no-headless\tflag\t❌\t是否无头模式（默认 headless）\n\n--comment-id 和 --user-id 至少需要提供一个。\n\n示例：\n\nxhs-mcp reply-comment --feed-id FEED_ID --xsec-token XSEC_TOKEN -c \"回复内容\" --comment-id COMMENT_ID\n\n退出登录\n\n命令：xhs-mcp logout\n\n会删除本地 cookies。\n\n（可选）MCP 模式\n\n如果你的运行环境支持 MCP（例如 Claude Desktop / Cursor），可以启动 MCP：\n\nxhs-mcp serve"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/luweizheng/post2xhs",
    "publisherUrl": "https://clawhub.ai/luweizheng/post2xhs",
    "owner": "luweizheng",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/post2xhs",
    "downloadUrl": "https://openagent3.xyz/downloads/post2xhs",
    "agentUrl": "https://openagent3.xyz/skills/post2xhs/agent",
    "manifestUrl": "https://openagent3.xyz/skills/post2xhs/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/post2xhs/agent.md"
  }
}