xhs-interact

Installation
SKILL.md

输入判断

根据用户意图路由:

  • 点赞/取消点赞 → 点赞流程
  • 收藏/取消收藏 → 收藏流程
  • 发表评论 → 评论流程
  • 回复评论 → 回复流程

约束

  • 评论和回复执行前展示内容让用户确认(评论以用户身份公开发表,无法撤回)
  • 点赞和收藏可直接执行(操作可逆,MCP 服务有幂等处理)
  • 所有操作都需要 feed_id + xsec_token(来自搜索或详情结果,编造会导致报错)

执行流程

点赞

调用 like_feed

  • feed_id(string,必填)
  • xsec_token(string,必填)
  • unlike(bool,可选)— true 取消点赞,默认 false 点赞

已点赞时再点赞会自动跳过,反之同理。

收藏

调用 favorite_feed

  • feed_id(string,必填)
  • xsec_token(string,必填)
  • unfavorite(bool,可选)— true 取消收藏,默认 false 收藏

已收藏时再收藏会自动跳过,反之同理。

发表评论

调用 post_comment_to_feed

  • feed_id(string,必填)
  • xsec_token(string,必填)
  • content(string,必填)— 评论内容

发送前展示评论内容让用户确认。

回复评论

调用 reply_comment_in_feed

  • feed_id(string,必填)
  • xsec_token(string,必填)
  • comment_id(string,可选)— 目标评论 ID
  • user_id(string,可选)— 目标评论作者 ID
  • content(string,必填)— 回复内容

comment_iduser_id 至少提供一个。

发送前展示回复内容让用户确认。

失败处理

场景 处理
未登录 引导使用 xhs-login
缺少 feed_id/xsec_token 提示先搜索或浏览获取笔记信息
笔记不可评论 告知用户该笔记已关闭评论
Weekly Installs
3
GitHub Stars
203
First Seen
Mar 24, 2026