ae_reddit_comment_request
查询指定 Reddit 帖子的评论。必填 reddit_id,须带 t3_ 前缀,可从 social_media_search 获取。可选 page 用于指定页码,默认为第 1 页,每页返回 20 条记录。上游未定义具体响应结构。
AgentEarth 工具目录
提供社交媒体账号、帖子与笔记、评论及互动数据的查询能力,支持账号研究、话题追踪和内容表现分析,覆盖 X(Twitter)、小红书、Reddit、TikTok 等平台。
工具列表
ae_reddit_comment_request
查询指定 Reddit 帖子的评论。必填 reddit_id,须带 t3_ 前缀,可从 social_media_search 获取。可选 page 用于指定页码,默认为第 1 页,每页返回 20 条记录。上游未定义具体响应结构。
ae_douyin_creator_fetch_creator_hot_topic_billboard
获取抖音创作者热门话题榜单,按内容分类、排序指标和时间范围发现热门话题。 输入参数(均为可选整数): - billboard_tag:分类标签,默认 0,表示全部。已知标签:333=美食、334=旅行、299=泛生活、335=汽车、336=科技、302=游戏、296=二次元、337=娱乐、311=明星、298=体育、300=文化教育、301=校园、297=政务、305=时尚、306=才艺、669=财经、314=随拍、307=动植物、309=图文控、308=剧情、315=亲子、718=三农、310=创意、312=户外、926=公益。其他标签值应从分类配置中获取,不应自行猜测。 - order_key:排序指标,1=播放最高(默认)、2=点赞最多、3=评论最多、4=投稿最多。 - time_filter:时间范围,1=24小时(默认)、2=7天、3=30天。 返回所选条件下的创作者热门话题榜单数据,位于响应的 data 字段;榜单条目的详细结构未作明确约定。此工具查询话题榜单,而非单个创作者的排名,无需提供创作者 ID 或话题关键词。 示例:billboard_tag=0、order_key=1、time_filter=1,表示查询全部分类中按播放量排序的24小时热门话题榜单。
ae_douyin_index_fetch_item_sug
获取视频搜索的关键词自动补全建议。 输入: - query(必填,字符串):需要获取建议的搜索关键词,例如“打瓦”。 返回: - 与关键词匹配的搜索建议,用于补全或调整搜索词,而不是视频列表。 - 建议内容位于响应数据中;单条建议的具体字段结构未作规定。
ae_douyin_index_fetch_portrait
查询指定关键词在抖音或头条、指定日期范围内的人群画像。 输入参数: - keyword(必填):要分析的关键词。 - start_date(必填):开始日期,使用 YYYYMMDD 格式的字符串,例如 "20260406"。 - end_date(必填):结束日期,使用 YYYYMMDD 格式的字符串,例如 "20260412"。 - app_name(可选):aweme 表示抖音(默认值),toutiao 表示头条。 返回含义:响应的 data 字段承载人群画像分析结果,可包含性别、年龄、地域、兴趣等分布,用于了解所选平台及时间范围内与关键词相关的人群特征。具体维度和数值格式以实际返回为准;响应结构未规定固定的画像明细字段,data 也可能为空。
ae_douyin_xingtu_search_anchor
## 用途 按主播昵称、抖音号、星图 ID 或直播内容关键词搜索抖音直播主播,并结合合作需求、报价、表现和受众画像筛选候选主播。 ## 输入条件 - **必填:**`keyword`,字符串类型的搜索关键词。 - **分页与排序:**`page` 默认 `1`;`sort_field` 默认 `score`,表示综合排序;`sort_type` 为 `1` 时升序、`2` 时降序,默认 `2`。 - **合作诉求:**`task_category` 为合作对象,默认 `6`;`marketing_target` 为营销目标,默认 `3`;`first_industry_id` 为适配行业 ID;`author_list_id` 为主题推荐达人清单 ID。 - **达人匹配:**`tag` 为逗号分隔的达人类型 ID;`persona_tags` 为人设、学历、认证或调性 ID,逗号表示满足任一,分号分组表示每组都需满足;`gender` 为 `1` 表示男、`2` 表示女;`fans_min`/`fans_max` 设置粉丝数范围。 - **直播报价:**`price_min`/`price_max` 为非负整数;提供任一边界时,须同时提供 `price_type=9`。这里筛选的是主播直播报价,并非工具使用费用。 - **表现指标:**`expected_play_min`/`expected_play_max` 筛选预期播放量;`cpm_min`/`cpm_max`、`cpe_min`/`cpe_max` 筛选预期 CPM/CPE;`interact_rate_min`/`interact_rate_max`、`play_over_rate_min`/`play_over_rate_max`、`burst_text_rate_min`/`burst_text_rate_max` 分别筛选互动率、完播率和爆文率。比率使用 `0–1` 小数,例如 `0.02` 表示 2%。 - **画像筛选:**`extra_filter` 必须是 JSON 数组的**字符串**,不能直接传数组。每项须含非空字符串 `field_name` 和 `field_value`,可选 `rel_id`。可用于内容主题、观众/粉丝画像、人群、地域等条件;应使用已知的有效字段和编码,不要自行编造 ID。例如字符串 `[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.6"}]` 表示按已定义的女性观众占比阈值筛选。 ## 返回含义 返回匹配主播的搜索结果数据。文档列出的信息包括主播资料、直播报价、ACU/PCU(平均/峰值同时在线人数)及场均观看等,具体以实际返回为准。结果数据未定义固定的详细结构,也可能为 null,不保证每项指标均存在。本工具用于发现和筛选主播,不会发起合作预订或播放直播。 ## 示例 `{"keyword":"游戏","page":1,"gender":2,"fans_min":10000}`:按“游戏”关键词搜索,并筛选女性、粉丝数至少 10000 的主播。
ae_x_get_latest_post_comments
获取指定 X(Twitter)帖子的最新评论。 输入: - tweet_id(必填,字符串):要获取评论的帖子 ID。 - cursor(可选,字符串):上一次响应返回的分页游标。首次请求时省略;继续翻页时传入已返回的游标。 返回:指定帖子的评论数据。响应未定义单条评论的固定结构,也未规定分页游标的固定字段位置。
ae_douyin_billboard_fetch_hot_account_fans_interest_search_list
获取指定抖音账号的粉丝近 3 天搜索词,共 10 个,用于了解粉丝近期搜索兴趣。 输入:sec_uid(必填,字符串),即目标账号的用户 sec_id。 返回:搜索词数据及响应元信息;具体结果字段未作定义。搜索词反映该账号粉丝的搜索兴趣,并非账号本人搜索历史。时间范围与词条数量固定,不支持自定义日期或返回数量。
ae_douyin_creator_fetch_creator_material_center_billboard
## 用途 获取抖音创作者中心素材中心的热门视频榜单,用于热点发现和内容选题参考。 ## 输入 所有参数均为可选整数。 - `billboard_tag`:分类标签,默认 `0` 表示全部。已记录的分类值:`333` 美食、`334` 旅行、`299` 泛生活、`335` 汽车、`336` 科技、`302` 游戏、`296` 二次元、`337` 娱乐、`311` 明星、`298` 体育、`300` 文化教育、`301` 校园、`297` 政务、`305` 时尚、`306` 才艺、`669` 财经、`314` 随拍、`307` 动植物、`309` 图文控、`308` 剧情、`315` 亲子、`718` 三农、`310` 创意、`312` 户外、`926` 公益。应使用有文档依据的分类值,不要猜测其他数值。 - `order_key`:排序指标,`1` 播放最高(默认)、`2` 点赞最多、`3` 评论最多、`4` 热度最高。 - `time_filter`:时间范围,`1` 24小时(默认)、`2` 7天、`3` 30天。 ## 返回 `data` 承载所请求的热门视频榜单数据,响应还包含相关元信息。文档未规定榜单数据的详细结构,且 `data` 可以为空,因此不保证具体视频字段或条目数量。 ## 示例 `{"billboard_tag":333,"order_key":2,"time_filter":2}` 表示查询美食分类近7天点赞最多的热门视频榜单。不传参数时,查询全部分类近24小时播放最高的榜单。
ae_douyin_search_fetch_challenge_search_v1
## 用途 按关键词搜索抖音话题(挑战/标签),用于发现相关话题及查看其热度、参与情况等信息。返回的是话题条目,不是单条视频或图文作品列表。 ## 输入条件 必须提供 `request_body` 对象,其中各字段均为可选: - `keyword`(字符串):搜索关键词,例如 `美食`;默认值为 `猫咪`。 - `cursor`(整数):翻页游标;首次请求使用默认值 `0`。 - `search_id`、`backtrace`(字符串):翻页标识;默认均为空字符串。继续翻页时,使用上次响应提供的游标及相应标识(如有返回)。 - `sort_type`(字符串):`"0"` 综合排序,`"1"` 最多点赞,`"2"` 最新发布。 - `publish_time`(字符串):`"0"` 不限,`"1"` 最近一天,`"7"` 最近一周,`"180"` 最近半年。 - `filter_duration`(字符串):`"0"` 不限,`"0-1"` 一分钟以内,`"1-5"` 一到五分钟,`"5-10000"` 五分钟以上。 - `content_type`(字符串):`"0"` 不限,`"1"` 视频,`"2"` 图片,`"3"` 文章。 排序及筛选字段默认均为 `"0"`。虽然支持内容类型等筛选参数,文档说明返回内容仍仅为话题。 ## 返回含义 返回包含状态码 `code` 和结果数据 `data` 的响应对象;`data` 可能为空。文档列出的常见搜索数据包括: - `challenge_list`:话题列表。条目中的 `challenge_info` 可包含 `cid`(话题 ID)、`cha_name`(名称)、描述、`view_count`(总浏览量)、`user_count`(参与人数)、`hashtag_profile`(封面地址),以及分享链接和应用跳转链接。 - 条目中的 `author`:创建者信息,例如用户 ID、昵称、粉丝数、认证状态、地区和头像地址。 - `cursor`:下次请求使用的游标;`has_more`:`1` 表示还有更多结果,`0` 表示没有更多结果。 结果数据没有固定的详细结构,上述字段为文档列举的常见字段,不保证每次全部出现。翻页标识及话题详情请以实际响应为准。
ae_douyin_search_fetch_challenge_suggest
## 用途 根据关键词获取抖音话题、挑战或标签的搜索建议,适用于搜索框联想和相关话题发现。 ## 输入 - `request_body`(必填对象):请求体。 - `request_body.keyword`(可选字符串):搜索关键词,例如 `游戏`;参数结构中声明的默认值为 `游戏`。 示例: ```json {"request_body":{"keyword":"游戏"}} ``` 请求体内仅公开关键词参数;本工具的公开参数结构不支持分页输入。 ## 返回含义 响应外层包含 `code`(HTTP 状态码)、`data`(结果数据)及响应元数据。结果数据中常见字段包括: - `sug_list`:话题建议列表;条目中的 `cha_name` 为话题名称,`view_count` 为总浏览量,`cid` 为话题/挑战 ID,`group_id` 为关联群组 ID,`tag` 为分类(0 表示普通话题,1 表示流量风向标)。 - `status_code`:结果状态码,0 表示成功。 - `status_msg`:结果状态说明。 - `rid`:结果请求 ID;也可能包含查询和日志相关元数据。 结果数据未限定完整字段结构,具体字段及其是否出现以实际响应为准。返回内容是话题建议,不是视频或用户搜索结果。
ae_douyin_xingtu_get_kolid_by_sec_user_id
根据抖音用户的 sec_user_id 查询其游客视角可获取的星图 KOL 标识(kolid)。 输入:sec_user_id 为必填字符串,填写抖音用户的 sec_user_id,可从抖音用户资料中获取。请提供标识本身,不要用昵称或个人主页链接代替。 返回:查询对应的星图 kolid,用于标识该用户在星图中的身份,与输入的抖音 sec_user_id 不同。响应采用通用封装,其中 data 的具体数据结构未明确说明。
ae_tiktok_ads_get_top_contents_list
### 用途 获取指定周期和国家/地区的创意中心热门内容榜单,适合趋势发现、内容研究和创意选题。榜单总量为 100 条视频;通过 `page` 和 `limit` 返回其中一页。 ### 输入 在 `request_body` 中提供必填的 `period_end_timestamp`:根据目标榜单日期生成的非零 10 位 Unix 秒级时间戳。`period_dimension=1`(周榜)时使用周日 00:00 UTC;`period_dimension=3`(日榜)或 `5`(长周期榜)时使用已过去日期的时间戳。 可选字段: - `period_dimension`:`1` 周榜、`3` 日榜(默认)或 `5` 长周期榜。 - `country_code`:国家/地区代码(默认 `US`);部分地区可能没有榜单数据。 - `content_label_ids`:用逗号分隔的内容分类 ID;留空表示全部分类。 - `order_by_metric`:`1` 播放量(默认)、`2` 互动率或 `3` 6 秒完播率。 - `organic_only`:是否仅返回自然流量内容(默认 `false`)。 - `page`:页码(默认 `1`)。 - `limit`:每页数量(默认 `20`,最大 `100`)。 - `cookie`:可选的自定义 Cookie 字符串。 ### 返回 响应数据包含 `entityInfos`(排名视频列表)和 `pagination`(分页信息)。视频条目可包含标题、创建时间、封面和视频 URL 等基础信息,播放量、互动率和 6 秒完播率等表现指标,作者信息与粉丝指标,以及内容标签。选定地区未被覆盖时,`entityInfos` 为空可能是正常结果。超出 100 条榜单范围的页码可能返回超范围错误。
ae_tencent_huxuan_search_video_account_creators
搜索或浏览视频号创作者,用于发现潜在合作达人和广告策划。keyword 为可选的达人昵称关键词,默认空字符串,留空时浏览默认市场列表;page 为可选的整数页码,从 1 开始,默认值为 1。返回内容包含查询数据(data)、状态码(code)、消息(message)和记录时间(recordTime)。返回定义未限定 data 的内部结构或具体达人字段,请以实际返回内容为准。
ae_dataforseo_serp_youtube_video_subtitles_live_advanced
使用 DataForSEO 获取 YouTube 视频的字幕及翻译内容。
ae_bilibili_fetch_user_relation_stat
### 用途 查询指定 UID 用户的关系数量统计。 ### 输入 - `uid`(字符串,必填):用户的 UID。 ### 返回 返回关系统计数据,包括 `following`(关注数)和 `follower`(粉丝数)。
ae_douyin_fetch_brand_hot_search_list
获取抖音品牌热搜榜的分类数据。 输入:无需参数,使用空对象({})调用。 返回:JSON 响应,其中 data 字段承载分类数据,并附带响应状态等信息。data 可能为空,具体分类数据结构未作定义。本工具不接受品牌、分类、日期或分页筛选参数;其已说明的用途是获取榜单分类,而非查询单个品牌的排名详情。