ae_tiktok_analytics_fetch_video_metrics
获取单个 TikTok 视频的详细分析数据。请提供必填的 `item_id`(视频或作品 ID)。返回结果可能包括总观看量、点赞数、评论数和收藏数;发布后最多 14 天的可用每日趋势数据;以及包含标题、内容和概览类型的视频表现概览。请使用视频 ID,而不是个人资料或账号 ID。
AgentEarth 工具目录
提供社交媒体账号、帖子与笔记、评论及互动数据的查询能力,支持账号研究、话题追踪和内容表现分析,覆盖 X(Twitter)、小红书、Reddit、TikTok 等平台。
工具列表
ae_tiktok_analytics_fetch_video_metrics
获取单个 TikTok 视频的详细分析数据。请提供必填的 `item_id`(视频或作品 ID)。返回结果可能包括总观看量、点赞数、评论数和收藏数;发布后最多 14 天的可用每日趋势数据;以及包含标题、内容和概览类型的视频表现概览。请使用视频 ID,而不是个人资料或账号 ID。
ae_instagram_fetch_similar_users
查找与指定 Instagram 账号相似的用户。 输入: - `username`:账号用户名,与 `user_id` 二选一。 - `user_id`:账号 ID,与 `username` 二选一。 请提供其中一个标识。响应中的 `data.items`(如有)包含相似用户推荐列表。
ae_instagram_fetch_user_followers
根据 Instagram 账号的用户名或用户 ID 获取其粉丝列表。请至少提供 username 或 user_id 之一。若结果支持继续分页,请将上一次响应返回的 pagination_token 传入下一次请求。结果包含标准响应封装,粉丝数据位于 data 字段中;有更多结果时还可能返回分页信息。
ae_kuaishou_app_hot_board_categories
### 用途 获取快手热榜的分类数据。 ### 输入 无需输入参数。 ### 返回 返回热榜分类数据;响应还可能包含请求时间、状态码等元数据。
ae_youtube_get_channel_short_videos
获取指定 YouTube 频道的短视频(Shorts)数据。 输入: - channel_id(必填,字符串):YouTube 频道 ID,例如 UCXuqSBlHAE6Xw-yeJA0Tunw。 - continuation_token(选填,字符串):用于继续获取该频道短视频的翻页令牌;首次请求时可省略。 返回:响应中的 data 承载频道短视频数据,具体内部字段结构未作约定。此工具获取视频信息,不提供视频文件下载。
ae_reddit_app_fetch_post_details
根据帖子 ID 获取单个 Reddit 帖子的详情,可选择获取指定评论的上下文。 输入参数: - post_id(必填):格式为 t3_ 加 1–17 位小写英文字母或数字,例如 t3_1ojnh50。必须使用带前缀的 ID,不能直接传入帖子链接或不带前缀的 ID。 - include_comment_id:设为 true 时,请通过 comment_id 指定需要获取上下文的评论;默认为 false。 - comment_id:请求指定评论上下文时,提供 t1_ 加 1–17 位小写英文字母或数字的评论 ID;默认为空字符串。 - language:期望的返回语言,使用 IETF 语言标签,长度为 2–16 个字符,例如 en-US;默认为 en-US。 - need_format:是否请求清洗和格式化数据;默认为 false。 返回包含状态元数据与帖子数据的响应。帖子数据可能包含标题、正文、作者、点赞和评论统计、所属版块、奖励、媒体资源及推荐原因等。数据未定义固定的详细结构,也可能为 null,不保证每项信息都存在。获取指定评论上下文不代表返回完整评论区。
ae_x_get_user_tweet_replies
通过 X(Twitter)账号用户名获取用户推文回复数据。 输入: - screen_name(必填,字符串):账号用户名。例如,https://twitter.com/elonmusk 中的 elonmusk。应传入用户名,而非完整主页链接。 - cursor(可选,字符串):上一轮响应中取得的分页游标。首次请求时省略;如响应提供后续游标,可用于请求下一页。 返回:包含用户推文回复数据的响应。具体回复结构及分页字段以实际响应为准,此处未定义其固定结构。本工具按账号查询,不是通过单条推文 ID 查询其回复。 首次请求示例:{"screen_name":"elonmusk"}
ae_linkedin_get_user_profile
通过完整的 LinkedIn 个人主页 URL 获取该用户的公开资料。 输入: - url(必填,字符串):用户个人主页的完整 URL,例如 https://www.linkedin.com/in/williamhgates/。 返回: - 同步直接返回查询结果,data 中可能包含姓名、当前公司、个人简介、所在地、粉丝数、工作经历和教育经历等公开信息。 - 实际可用字段可能不同;data 未定义固定的字段结构,也可能为 null,不保证包含上述所有信息。 请提供个人主页 URL,而非姓名或公司主页 URL。
ae_wechat_official_accounts_search_paginated
按关键词搜索微信公众号,用于发现创作者、品牌或发布方账号。必须提供 keyword。首页默认使用 currentPage=1、offset=0、cookies_buffer 为空字符串;继续浏览时,指定页码,并沿用上一次响应返回的 offset 和不透明分页状态 cookies_buffer,不要自行构造这些状态值。响应包含搜索数据 data,以及 code、message、recordTime 等信息。data 的具体结构未作约定,账号详情和后续分页值以实际返回为准。本工具用于搜索账号,而非搜索文章正文。
ae_quora_question_search
按品牌、产品品类或问题描述搜索 Quora 问题,用于了解用户疑问、购买顾虑、使用抱怨和经验分享。必填 search_name 支持中文或英文关键词。默认搜索过去一年内发布的问题,每页返回 20 条;page 从 1 开始,默认值为 1。可选 post_type 为问题类型代码字符串,多选时用英文逗号分隔:1=求助、2=购买咨询、3=抱怨、4=经验分享、5=讨论、6=创新、7=其他,默认值为空字符串。可选 main_sentiment 支持 1=正面、2=中性、3=负面,Schema 默认值为 0。上游未提供响应 Schema,因此不承诺特定返回字段。本工具用于问题搜索,不用于单独获取问题全文或回答。
ae_kuaishou_creator_audience
查询快手磁力聚星主播的整体观众画像,分别查看观众(viewers)和粉丝(fans)在性别、年龄、活跃度、地域及设备等维度的分布。各画像条目包含分类标签(label)、占比(share,0–1)和TGI指数;兴趣或群组数据可能为空。结果针对主播整体,不对应单场直播,也不提供单场直播ID或明确统计周期。
ae_telegram_fetch_channel_info
### 用途: - 获取公开 Telegram 频道的元信息:标题、简介、头像、订阅数、是否认证、统计计数器。 - 数据来自 t.me 公开预览页,无需登录。 ### 参数: - channel: 频道用户名(可传 `durov` / `@durov` / `https://t.me/durov`,会自动清洗)。 ### 返回: - `username` / `title` / `verified` / `description` / `photo` / `subscribers` / `counters`。 - 频道不存在或非公开时返回 `exists = false`;频道关闭网页预览时返回 `preview_available = false`。 AE调用参数示例: {"channel":"durov"}
ae_github_search_users
按姓名、邮箱或关注者数量等活动指标查找 GitHub 用户。
ae_douyin_billboard_fetch_hot_category_list
获取抖音热点榜分类的 ID 与热度信息。 输入说明: - billboard_type(必填):rise 表示上升热点榜,city 表示城市热点榜,total 表示热点总榜。 - snapshot_time:快照时间,格式为 yyyyMMddHHmmss。预设默认值为 20250106151500,并不表示获取最新快照。 - start_date、end_date:快照日期范围的开始和结束日期,格式为 yyyyMMdd。使用日期范围时必须移除 snapshot_time,不能保留其预设默认值。 - keyword(可选):热点搜索词。 请提供快照时间或日期范围,时间条件不能全部为空。 返回含分类 ID 与热度信息的热点榜分类结果,业务结果位于响应的 data 中;单条结果的具体结构未明确约定。
ae_douyin_billboard_fetch_hot_challenge_list
获取抖音热门挑战榜。 输入: - page(必填,整数):要查询的页码。 - page_size(必填,整数):每页数量。 - keyword(可选,字符串,默认为空字符串):查询使用的热点搜索词。 返回:包含挑战榜数据的响应,data 承载榜单数据,并附带响应状态和元信息。data 可能为空,已提供的响应结构未规定单条挑战的具体字段。
ae_douyin_convert_webcast_id_to_room_id
## 用途 将抖音直播间号转换为对应的房间号。 ## 输入 - `webcast_id`(必填,字符串):需要转换的直播间号,例如 `"775841227732"`。 ## 返回含义 返回包含房间号转换结果的响应,结果数据的具体字段结构未作明确约定。本工具用于标识转换,不用于获取直播内容或直播间详情。