ae_kuaishou_web_user_id_from_share_link
### 用途 根据用户分享链接获取对应的用户 ID。 ### 输入 - `share_link`:必填,用户分享链接,例如短链接或用户资料分享链接。 ### 返回 成功响应中的 `data` 字段为从链接解析出的用户 ID。
AgentEarth 工具目录
提供社交媒体账号、帖子与笔记、评论及互动数据的查询能力,支持账号研究、话题追踪和内容表现分析,覆盖 X(Twitter)、小红书、Reddit、TikTok 等平台。
工具列表
ae_kuaishou_web_user_id_from_share_link
### 用途 根据用户分享链接获取对应的用户 ID。 ### 输入 - `share_link`:必填,用户分享链接,例如短链接或用户资料分享链接。 ### 返回 成功响应中的 `data` 字段为从链接解析出的用户 ID。
ae_kuaishou_web_user_info
查询快手用户的主页资料和账号统计。 输入:必填参数 user_id 为字符串,必须传入用户主页链接中的 eid。例如,主页链接 https://www.kuaishou.com/profile/3xz63mn6fngqtiq 对应 user_id="3xz63mn6fngqtiq"。不支持纯数字 uid,也不要传入完整主页链接。 返回:直接返回用户资料,可包括昵称、头像链接、个人简介、性别,以及粉丝数、关注数和获赞数。文档示例中,data.userProfile.profile 包含主页资料,data.userProfile.ownerCount 包含统计数据,其中 fan 表示粉丝数、follow 表示关注数、like 表示获赞数。具体字段可能有所不同或缺失;此工具不返回用户作品列表。 如可配置请求超时,请设置为 30 秒以上。请求不保证每次成功,失败后可稍后重试。
ae_kuaishou_web_video_comments
提供必填的 photo_id,即可获取单个作品的评论。可选参数 pcursor 用于翻页:首次请求时留空或省略,后续请求使用响应中返回的 pcursor 获取下一页。响应包含评论数据,并可能附带状态和请求元数据。
ae_kuaishou_web_video_sub_comments
获取快手单个作品中指定根评论下的二级评论(回复)。 输入: - photo_id(必填,字符串):作品 ID。 - root_comment_id(必填,字符串):要查询其回复的根评论 ID。 - pcursor(可选,字符串,默认 ""):首次请求可省略或留空;后续翻页使用响应中返回的 pcursor,并保持 photo_id 和 root_comment_id 不变。 返回:包含评论结果及响应状态信息的响应对象;data 为评论结果,可能为空。评论结果的具体字段结构未作定义。本工具查询指定根评论下的回复,不用于获取作品的全部一级评论。
ae_wechat_get_account_services
查询微信公众号底部的自定义菜单及服务入口。 输入: - request_body(必填):包含 username 及可选 raw 的对象。 - request_body.username(必填):公众号用户名,支持 gh_…、关联小程序账号的 gh_…@app,以及 nikejdi 等自定义微信号。例如 gh_363b924965e9。可从文章详情响应的 $.data.content.user_name 获取。 - request_body.raw(可选布尔值,默认 true):true 返回原始菜单结构,false 返回精简解析结构。 返回含义: - raw=true:data 为原始菜单结构;公众号未配置自定义菜单时,data 为 {}。 - raw=false:$.data.biz_username 为公众号用户名,$.data.menu 为菜单按钮列表,可包含名称、类型、子菜单及跳转信息,以实际配置为准。未配置自定义菜单时,菜单列表为 []。 本工具只查询菜单信息,不会点击或执行服务入口。响应可能较慢,建议将客户端请求超时设置为 30 秒。
ae_wechat_get_article_ads
获取微信公众号文章内嵌的广告及广告位信息。 输入: - request_body(必填):包含文章链接和可选返回模式的对象。 - request_body.url(必填):mp.weixin.qq.com 域名下的公众号文章链接,如 https://mp.weixin.qq.com/s/… 短链,或带 __biz 等查询参数的 /s 长链。最长 2048 个字符,须符合输入结构规定的链接格式。 - request_body.raw(可选,默认 true):true 返回完整原始响应;false 返回拍平后的广告列表。 返回含义: - raw=false:data.count 为合并 advertisement_info 与 ad_slot_data 后的广告条数;data.ads 为广告项列表。文章无广告时,data.ads 为 []。 - raw=true:data.pages 为捕获到的响应页数;data.results 为每页的完整原始响应,其中 advertisement_info / ad_slot_data 是精简模式广告列表的数据来源。 本工具用于查询广告信息,不用于获取文章正文。响应可能较慢,建议将客户端请求超时设为 30 秒;超时设置属于客户端配置,不是工具输入参数。
ae_wechat_get_article_stats_h5
## 用途 查询微信公众号文章的评论总数与精选评论数。本工具仅返回评论统计,不返回文章正文或逐条评论内容。 ## 输入 传入 `request_body` 对象,包含: - `url`(必填):域名为 `mp.weixin.qq.com`、使用 `/s` 路径的公众号文章链接,例如 `https://mp.weixin.qq.com/s/…`,也支持带 `__biz` 的长链接;最长 2048 个字符。 - `raw`(可选,默认 `true`):为 `true` 时附带原始评论计数字段;为 `false` 时仅返回计数等基础字段。两种模式的顶层响应结构一致。 - `comment_id`(可选):文章评论 ID,使用不超过 32 个字符的数字字符串,也可传 `null`。若已从文章详情的 `$.data.content.comment_id` 获取该值,传入可减少文章解析工作;仍须提供 `url`。 ## 返回含义与限制 - `$.data.comment_count`:评论总数。 - `$.data.elected_comment_count`:精选评论数。 - `$.data.read_num`、`$.data.like_count`、`$.data.old_like_count`、`$.data.share_count`、`$.data.collect_count` 和 `$.data.star_num`:本工具无法获取,恒为 `null`,字段名同时列入 `$.data.unavailable[]`。无法获取不等于实际数值为 0。 - `raw=true` 时,额外返回 `$.data.comment_raw`,其中包含原始计数 `total_count`、`elected_total`,以及 `comment_id`、`appmsgid`。 请将 `comment_id` 和 `appmsgid` 按字符串接收与传递,避免大整数精度丢失。建议客户端超时设为 30 秒。如需阅读量、点赞、分享、收藏等不可用指标,应另选支持相应指标的文章统计工具;本工具不会自动切换。
ae_wechat_get_collection_videos
## 用途 查询指定微信视频号合集内的视频,返回视频信息、互动统计、媒体地址及翻页信息。每次调用返回一页,不一定覆盖整个合集。 ## 输入 必须提供 `request_body` 对象,其中包含: - `topic_id`(必填):从合集列表中获得的合集 ID,必须是最长 32 个字符的纯数字字符串。例如 `"14616794565351966924"`。 - `topic`(可选):合集名称,最长 100 个字符,用于提高匹配准确度。 - `username`(可选):创作者 finder 用户名,格式为 `v2_<十六进制字符>@finder`,最长 256 个字符,用于提高匹配准确度。 - `topic_type`(可选):0–1000 的整数,默认 `16`,应与合集列表中该合集的类型一致。 - `last_buffer`(可选):base64 翻页游标。首页留空;下一页原样传入上一页返回的游标。 - `raw`(可选):默认 `true`,返回完整原始结构;设为 `false` 返回精简结构,推荐用于媒体处理。 可选文本字段默认空字符串,也接受 null。合集名称或创作者用户名不能代替必填的合集 ID。 ## 返回与翻页 当 `raw=false` 时,`data` 包含: - `topic_id`、`title`:合集 ID 和名称。 - `total_count`:合集视频总数;`count`:本页条数。 - `videos[]`:视频 ID、创作者用户名和昵称、标题(可能为 null)、创建时间、浏览/点赞/收藏/转发/评论数,以及 `media` 媒体对象。媒体字段包括 `url`、`url_token`、`full_url`、`decode_key`、封面地址、时长、宽高和媒体类型。 - `down_continue`:是否还有下一页(`1` 表示有);`last_buffer`:下一页游标。 当 `raw=true` 时,视频数组为 `data.object[]`,总数为 `data.totalCount`,媒体位于 `data.object[N].objectDesc.media[0]`,字段为 `url`、`urlToken`、`decodeKey`。合集翻页以 `data.downContinueFlag` 为准,不要使用 `continueFlag`。游标为 `data.lastBuffer`(文档也标注别名 `data.last_buffer`),下一次调用时传入请求的 `last_buffer`。 ## 注意事项 - 合集及视频 ID 应始终按字符串保存和传递。响应中的 ID 可能超过 JavaScript 安全整数范围,应使用保留大整数精度的 JSON 解析方式,避免经过 JavaScript `Number`。 - 下载媒体时,优先使用精简结构的 `media.full_url`,它已拼接 `url` 和 `url_token`;原始结构需自行拼接 `url` 和 `urlToken`。直接使用不带令牌的 URL 可能无法访问。 - 若视频文件已加密,需另行使用同一次响应中的密钥解密;密钥每次请求都会变化。本工具仅返回媒体信息,不下载或解密文件。 - 响应可能较慢,建议将客户端请求超时设置为 30 秒。
ae_wechat_get_live_detail
## 用途 根据直播 ID 查询指定微信视频号直播间的主播信息、直播状态、在线人数及回放信息。 ## 输入条件 必须传入 `request_body` 对象,其中包含: - `live_id`(必填):纯数字字符串,最长 32 个字符,例如 `2078950291205875194`。可从直播入口、直播分享或直播历史中的回放条目获取。 - `scene`(可选):进入场景,取值为 0–1000 的整数,默认 5。 - `finder_username`(可选):主播标识,格式为 `v2_<十六进制字符>@finder`,最长 256 个字符;提供后可提高匹配命中率。默认为空字符串,也允许传入 null。 - `raw`(可选):默认 `true`。`true` 返回完整原始结构,`false` 返回精简字段。 ## 返回含义 直播间详情直接位于返回结果的 `data` 中。 - `raw=false` 时使用 snake_case 字段:`live_id`、`object_id` 分别表示直播 ID 和关联作品 ID;`anchor_nickname`、`anchor_username`、`anchor_head_url` 分别表示主播昵称、标识和头像;`live_cover_url` 为直播封面。`live_status` 表示直播状态(1=直播中,2=已结束,也可能有其他取值),`status_desc` 为状态文案。`online_count`、`max_online_count` 分别为当前和峰值在线人数。`replay_status`、`replay_url`、`replay_watch_uv` 分别表示回放状态、回放地址和回放观看人数。 - `raw=true` 时返回完整原始结构,包括保存直播及回放信息的 `data.liveInfo`、保存主播信息的 `data.anchorContact`。示例字段有 `data.liveInfo.liveId`、`liveStatus`、`onlineCnt`、`maxOnlineCount`、`replayUrl`,以及 `data.liveInfo.replayInfo.watchUv`。 关联作品 ID、状态文案和回放地址可能为空;已结束直播的在线人数通常为 0,不保证存在可用回放地址。 ## 使用注意 输入和处理返回结果时,应始终将大整数 ID 保持为字符串,并使用无损 JSON 解析方式,避免经过 JavaScript `Number` 导致精度丢失。请求可能较慢,建议将客户端请求超时设置为 30 秒。
ae_wechat_get_related_articles
获取指定微信公众号文章底部展示的「关联/相关文章」。 输入: - request_body(必填):包含文章链接及可选返回格式的对象。 - request_body.url(必填):mp.weixin.qq.com 下的公众号文章链接,支持 https://mp.weixin.qq.com/s/... 形式及带 __biz 的 /s?... 长链接;最长 2048 个字符。 - request_body.raw(可选,默认 true):true 返回完整原始响应;false 返回精简结果。 返回含义: - raw=false:data.articles 为关联文章列表,data.count 为文章数量,data.ret 为返回码(0 表示正常)。 - raw=true:data.list 为原始关联文章列表,data.article_size 为文章数量,data.base_resp.ret 为返回码;还可能包含原始响应中的其他元数据。 - 未开启关联文章功能的文章会返回空列表。本工具不是通用文章搜索或正文获取工具。 响应可能较慢,建议将客户端请求超时设置为 30 秒。
ae_wechat_get_user_collections
## 用途 获取微信视频号创作者主页上的合集列表,返回合集信息,不直接返回合集内的视频。 ## 输入 提供 `request_body` 对象,包含: - `username`(必填):创作者的 finder username,格式为 `v2_…@finder`,长度为 10–256 个字符,须匹配 `^v2_[0-9a-fA-F]+@finder$`。不能用昵称替代。 - `raw`(可选,布尔值,默认 `true`):`true` 返回完整原始结构;`false` 返回精简结构。 ## 返回含义 当 `raw=false` 时,`data.username` 为创作者的 finder username,`data.count` 为合集总数,`data.collections[]` 为合集列表,每项包含: - `topic_id`:合集 ID,可用于后续单独查询合集内的视频。 - `name`、`desc`:合集名称和简介,简介可能为空字符串。 - `cover_url`:合集封面图片链接。 - `feed_count`:合集内的视频数量。 - `topic_type`:合集类型,可与合集 ID 一起用于后续的视频查询。 当 `raw=true` 时,对应字段为 `data.collectionCount` 和 `data.collectionInfo[]`,每项包含 `collectionTopicId`、`collectionName`、`collectionDesc`、`coverImgUrl`、`feedCount`、`collectionTopicType`;`collectionTopicIdStr` 是合集 ID 的字符串别名。原始结构还可能包含 `lastUpdateTime`、`readCount`、`categoryId` 等字段。`data.lastBuffer` 为合集列表翻页游标,通常为空;本工具不提供翻页输入参数。 ## 注意事项 - 合集 ID 可能超过 JavaScript 安全整数范围。请使用无损 JSON 解析并以精确字符串保存、传递 ID;有 `collectionTopicIdStr` 时优先使用。不要让大整数 ID 经过 JavaScript `Number` 转换。 - 响应可能较慢,建议将客户端请求超时设置为 30 秒。
ae_youtube_get_channel_community_posts
## 获取 YouTube 频道社区帖子 获取指定频道的一页社区帖子,并支持通过分页令牌继续读取。 ### 输入参数 - **channel_id**(string,必填):YouTube 频道 ID,例如 `UCkRfArvrzheW2E7b6SVT7vQ`。可从 `https://www.youtube.com/channel/<channel_id>` 形式的频道链接中提取。 - **language_code**(string,可选,默认 `"zh-CN"`):语言代码,影响返回的文本语言。 - **country_code**(string,可选,默认 `"US"`):国家代码,例如 `US`、`JP`。 - **continuation_token**(string,可选):上一次响应返回的下一页令牌;首次请求时不传。 - **need_format**(boolean,可选,默认 `true`):为 true 时返回清洗后的结构化数据,为 false 时返回原始响应数据。 ### 返回含义 当 `need_format=true` 时,响应数据包含: - **channel_id**:频道 ID。 - **posts**:社区帖子列表。每条帖子包含 `post_id`、`post_url`、作者信息(`author_name`、`author_channel_id`、`author_url`、`author_thumbnails`)、正文 `content_text`、相对发布时间 `published_time`、点赞数 `vote_count`、评论数 `comment_count` 和附件 `attachment`。附件可为图片、多图、视频、投票,也可能为 null。 - **continuation_token**:下一页分页令牌。 - **has_more**:是否还有更多帖子。 - **total_count**:当前页帖子数量,不是频道的帖子总数。 当 `need_format=false` 时,响应数据为原始数据,不采用上述规范化结构。 ### 分页与限制 首次请求传入 `channel_id`,不传分页令牌。继续读取时,传入同一 `channel_id` 和上一页返回的 `continuation_token`;使用格式化结果时,读取至 `has_more=false` 为止。部分频道可能没有社区或帖子标签页。本工具获取社区帖子,不用于获取频道视频列表或评论明细。
ae_youtube_get_channel_url
通过 YouTube 频道 ID 查询频道用户名及频道链接。 输入:必填字符串 channel_id,例如 UCeu6U67OzJhV1KwBansH3Dg。请填写频道 ID,而非 @用户名或频道 URL。 文档说明的返回内容包括: - channel_id:频道 ID。 - handle:频道用户名,例如 CozyCraftYT。 - title:频道名称。 - channel_url:/channel/ 格式的标准频道链接。 - vanity_url:/@用户名格式的个性化频道链接。 适用于已知频道 ID,需要识别频道或展示便于阅读、分享的频道链接的场景。
ae_youtube_get_post_comment_replies
获取 YouTube 帖子中某条评论的回复(二级评论),按页返回。 输入参数: - continuation_token(必填,字符串):首次查询时,使用帖子一级评论结果中该评论的 reply_continuation_token;查询后续页时,使用上一次回复结果返回的 continuation_token。 - language_code(可选,字符串):语言代码,默认 "zh-CN"。 - country_code(可选,字符串):国家代码,默认 "US"。 - need_format(可选,布尔值):是否清洗和格式化数据,提取关键内容并移除冗余数据,默认 true。 返回含义:need_format=true 时,结果数据包含 comments 回复列表,回复信息包括 comment_id(评论 ID)、content(评论正文)、published_time(发布时间)、like_count(点赞数)和 author(作者信息)。如有更多回复,还会返回用于下一页的 continuation_token。设置 need_format=false 可关闭清洗和格式化;上述格式化字段说明适用于 need_format=true。 使用前需先获取帖子一级评论以取得初始回复令牌。单次调用返回一页回复,不保证包含整个回复线程;如返回下一页 continuation_token,可继续调用获取后续回复。
ae_youtube_get_post_comments
## 用途 获取 YouTube 社区帖子的评论,支持分页。本工具用于帖子评论,不用于视频评论,也不直接获取某条评论下的回复。 ## 输入条件 `post_id` 与 `continuation_token` 至少提供一个: - `post_id`(字符串):首次请求时使用的社区帖子 ID,可从帖子链接中提取。例如链接 `https://www.youtube.com/post/UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy` 中的帖子 ID 为 `UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy`。 - `continuation_token`(字符串):首次请求也可使用帖子详情返回的 `comments_continuation_token`;获取后续页时,使用上一次评论响应返回的 `continuation_token`。 可选设置: - `language_code`(字符串):语言代码,默认 `"zh-CN"`。 - `country_code`(字符串):国家代码,默认 `"US"`。 - `need_format`(布尔值):是否清洗并格式化返回数据,默认 `true`。下述字段说明适用于格式化结果,不保证未格式化结果具有相同结构。 ## 返回含义 当 `need_format=true` 时,结果数据包括: - `comments`:当前页的评论列表。评论字段包括 `comment_id`(评论 ID)、`content`(正文)、`published_time`(发布时间)、`like_count`(点赞数)、`like_count_a11y`(点赞数无障碍文本)、`reply_count`(回复数)和 `reply_count_text`(回复数文本)。 - 每条评论的 `author`:作者信息,包括 `channel_id`(频道 ID)、`display_name`(显示名称)、`channel_url`(频道链接)、`avatar_url`(头像链接)、`is_verified`(是否认证)和 `is_creator`(是否为创作者)。 - 每条评论的 `reply_continuation_token`(如有):用于通过单独的回复获取工具读取该评论的回复。 - `continuation_token`(如有):用于获取下一页帖子评论的分页令牌。 继续翻页时,将结果中的分页令牌作为下一次请求的 `continuation_token`。不要把单条评论的回复令牌当作本评论列表的下一页令牌。
ae_youtube_get_post_detail
## YouTube 社区帖子详情 获取单个 YouTube 社区帖子的文本、作者信息、附件及互动数据。 ### 输入参数 - **post_id**(string,必填):帖子 ID,文档说明以 `Ugk` 开头。从 YouTube 帖子链接的 `/post/` 后提取,仅传入 ID,不传完整链接。例如:`UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy`。 - **language_code**(string,可选):语言代码,如 `zh-CN`、`en-US`。默认 `zh-CN`。 - **country_code**(string,可选):国家代码,如 `US`、`JP`。默认 `US`。 - **need_format**(boolean,可选):是否清洗并格式化返回数据。默认 `true`。 ### 返回含义 当 `need_format=true` 时,响应数据包括: - **post**:帖子 ID、帖子链接、作者名称、作者频道 ID 和链接、作者头像缩略图、帖子文本、相对发布时间、点赞数(`vote_count`)、评论数以及附件。附件可为单图、多图、视频或投票,也可能为 `null`。 - **channel_metadata**:频道名称、描述、链接等元数据。 - **comments_continuation_token**:用于后续获取评论的分页令牌,不是评论列表本身。 当 `need_format=false` 时,响应数据为未经上述格式化处理的原始数据。