juhecli-wx-sns 个微朋友圈
SKILL: juhecli-wx-sns — 微信个微朋友圈管理功能,包括浏览朋友圈、发布朋友圈、评论点赞删除等互动操作
使用案例
发一条朋友圈:今天天气真好给张三的朋友圈点赞评论李四的朋友圈
查看朋友圈
浏览最新的朋友圈动态
>帮我看看朋友圈
// Agent 调用 wx sns timeline 获取朋友圈列表
$juhe-cli wx sns timeline '{"max_id": "", "first_page_md5": "", "source_type": 0}'
{
"posts": [
{
"object_id": "obj_001",
"username": "wxid_zhangsan",
"content": "今天天气真好",
"like_count": 5
},
{
"object_id": "obj_002",
"username": "wxid_lisi",
"content": "分享了一本好书",
"like_count": 3
}
]
}
点赞朋友圈
为指定朋友圈动态点赞
>给第一条朋友圈点赞
// Agent 从 timeline 获取 object_id 后点赞
$juhe-cli wx sns like '{"object_id": "obj_001", "status": 1}'
{
"status": 0,
"msg": "点赞成功"
}
概述
个微朋友圈 SKILL 由 juhecli-wx-sns 提供,支持完整的微信朋友圈操作功能。 包括浏览朋友圈时间线、查看指定用户的朋友圈、发布文字和图片朋友圈、评论互动、点赞取消点赞、删除朋友圈等 8 个命令。
发布带图片的朋友圈时,需要先使用
wx cloud upload_sns_image 上传图片获取 content_url, 然后再调用 wx sns post 发布朋友圈。SKILL 包
| SKILL 名称 | 说明 |
|---|---|
juhecli-wx-sns | 个微朋友圈管理 - 浏览/发布/评论/点赞/删除朋友圈 |
触发方式
当用户提出以下意图时,Agent 应激活此 SKILL:
- "看看朋友圈" / "刷朋友圈" / "朋友圈动态"
- "发朋友圈" / "发布朋友圈" / "发一条带图片的朋友圈"
- "给张三的朋友圈点赞" / "给这条朋友圈点赞"
- "评论朋友圈" / "回复评论"
- "看看张三的朋友圈" / "查看某人的朋友圈"
- "删除我的朋友圈" / "删除评论"
详细说明
获取朋友圈时间线 (timeline)
浏览朋友圈动态列表,支持通过 max_id 翻页。
bash
wx sns timeline '{"max_id": "", "first_page_md5": "", "source_type": 0}'参数:
max_id(string, 可选) — 翻页参数,传入上一页最后一条动态的 IDfirst_page_md5(string, 可选) — 首页 MD5,翻页时使用source_type(int, 可选) — 来源类型,默认 0
返回值:
- 朋友圈动态列表,每条动态包含
object_id等信息,用于后续操作
获取用户朋友圈 (userpage)
查看指定用户的朋友圈动态。
bash
wx sns userpage '{"username": "wxid_xxx", "max_id": "", "first_page_md5": "", "source_type": 0}'参数:
username(string, 必填) — 用户的 username[需查询]max_id(string, 可选) — 翻页参数first_page_md5(string, 可选) — 首页 MD5source_type(int, 可选) — 来源类型,默认 0
获取朋友圈详情 (object_detail)
查看某条朋友圈动态的详细信息。
bash
wx sns object_detail '{"object_id": "xxx", "source_type": 0}'参数:
object_id(string, 必填) — 朋友圈动态 ID[来自 timeline/userpage 返回]source_type(int, 可选) — 来源类型,默认 0
发布朋友圈 (post)
发布文字或带图朋友圈。
bash
wx sns post '{"title": "今天天气真好", "content_url": ""}'参数:
title(string, 必填) — 朋友圈文本内容[用户提供]content_url(string, 可选) — 内容 URL(含图片时需先上传获取)[来自 upload_sns_image 返回]
发布带图朋友圈需要两步:先调用
wx cloud upload_sns_image 上传图片获取 content_url, 然后将返回的 URL 作为 content_url 参数传入 post 命令。评论朋友圈 (comment)
bash
wx sns comment '{"object_id": "xxx", "content": "不错", "reply_comment_id": "0"}'参数:
object_id(string, 必填) — 朋友圈动态 ID[来自 timeline 返回]content(string, 必填) — 评论内容[用户提供]reply_comment_id(string, 可选) — 回复的评论 ID,默认 "0" 表示直接评论动态
删除评论 (delete_comment)
bash
wx sns delete_comment '{"object_id": "xxx", "comment_id": "123"}'参数:
object_id(string, 必填) — 朋友圈动态 ID[来自 timeline 返回]comment_id(string, 必填) — 评论 ID[来自 timeline 返回]
点赞/取消点赞 (like)
bash
wx sns like '{"object_id": "xxx", "status": 0}'参数:
object_id(string, 必填) — 朋友圈动态 ID[来自 timeline 返回]status(int, 必填) — 0=取消点赞, 1=点赞
删除朋友圈 (delete)
bash
wx sns delete '{"object_id": "xxx"}'参数:
object_id(string, 必填) — 自己的朋友圈动态 ID[来自 timeline 返回]
只能删除自己发布的朋友圈,无法删除他人的朋友圈动态。
参数来源说明
| 参数 | 来源标记 | 获取方式 |
|---|---|---|
object_id | [来自 timeline/userpage 返回] | 通过 wx sns timeline 或 wx sns userpage 获取 |
comment_id | [来自 timeline 返回] | 通过 wx sns timeline 获取 |
username | [需查询] | 通过 db contact search 查询联系人获取 |
title | [用户提供] | 用户直接提供朋友圈文字内容 |
content | [用户提供] | 用户直接提供评论内容 |
content_url | [来自 upload_sns_image 返回] | 通过 wx cloud upload_sns_image 上传图片获取 |
典型工作流
浏览朋友圈
wx sns timeline— 获取朋友圈动态列表wx sns object_detail— 查看感兴趣的动态详情
朋友圈互动(点赞/评论)
wx sns timeline— 获取朋友圈列表- 提取
object_id wx sns like或wx sns comment— 进行互动
发布带图朋友圈
wx cloud upload_sns_image— 上传图片,获取 content_urlwx sns post— 传入 title 和 content_url 发布朋友圈
查看某人朋友圈
db contact search— 查询联系人获取 usernamewx sns userpage— 查看该用户的朋友圈动态wx sns object_detail— 查看具体动态详情
删除自己的评论或朋友圈
wx sns timeline— 找到目标动态wx sns delete_comment— 删除评论wx sns delete— 删除自己的朋友圈
AI Agent 调用示例
wx sns timeline + like + comment
text
// 用户:帮我看看朋友圈
AI: 好的,我来获取最新的朋友圈动态。
[调用 wx sns timeline]
AI: 已获取到 10 条朋友圈动态:
1. 张三:今天天气真好(3 条评论,5 个赞)
2. 李四:分享了一张美食照片(2 条评论)
...
// 用户:帮第一条点赞
AI: 好的,我来为这条朋友圈点赞。
[从 timeline 获取 object_id]
[调用 wx sns like {"object_id":"obj_001","status":1}]
AI: 点赞成功!
// 用户:评论第二条说"看起来很好吃"
AI: 好的,我来发布评论。
[调用 wx sns comment {"object_id":"obj_002","content":"看起来很好吃","reply_comment_id":"0"}]
AI: 评论发布成功!wx sns post(带图朋友圈)
text
// 用户:发一条朋友圈,文字"今天天气真好",配上这张图 https://example.com/sunset.jpg
AI: 好的,我先上传图片。
[步骤 1: 上传图片]
[调用 wx cloud upload_sns_image {"url":"https://example.com/sunset.jpg"}]
→ content_url: "sns_img_xxx"
[步骤 2: 发布朋友圈]
[调用 wx sns post {"title":"今天天气真好","content_url":"sns_img_xxx"}]
AI: 朋友圈发布成功!文字和图片均已发布。wx sns userpage
text
// 用户:看看张三的朋友圈
AI: 好的,我先查询张三的信息。
[调用 db contact search {"keyword":"张三"}] → username="wxid_zhangsan"
[调用 wx sns userpage {"username":"wxid_zhangsan"}]
AI: 已获取到张三的朋友圈动态:
1. 4月10日:周末爬山
2. 4月8日:分享了一本书
...
// 用户:看看第一条的详情
AI: 好的,我来获取详情。
[调用 wx sns object_detail {"object_id":"obj_xxx"}]
AI: 动态详情:周末去爬了香山,风景很美...完整工作流:点赞并评论
text
// 用户:帮我给张三的朋友圈点赞并评论"拍得不错"
AI: 好的,我来操作。
[步骤 1: 浏览朋友圈找到张三的动态]
[调用 wx sns timeline {"max_id":"","first_page_md5":"","source_type":0}]
→ 找到张三的动态,object_id: "obj_001"
[步骤 2: 点赞]
[调用 wx sns like {"object_id":"obj_001","status":1}]
→ 点赞成功
[步骤 3: 评论]
[调用 wx sns comment {"object_id":"obj_001","content":"拍得不错","reply_comment_id":"0"}]
→ 评论成功
AI: 已为张三的朋友圈点赞并评论"拍得不错"!错误处理
- object_id 不存在或已删除:返回错误,该朋友圈可能已被删除
- 非好友无法查看朋友圈:返回权限错误,需要先添加好友
- 评论失败:可能被对方设置为不可评论,或朋友圈已关闭评论
- 发布失败:检查内容是否符合朋友圈规范,图片是否上传成功
- 删除失败:只能删除自己的朋友圈或自己发布的评论
朋友圈操作需要注意频率限制,过频繁的操作可能被微信限制。建议适当控制操作频率, 避免短时间内大量点赞或评论。