mirror of
https://github.com/simstudioai/sim.git
synced 2026-02-08 13:45:03 -05:00
9a6a6fdacb
* improvement(docs): updated script to copy over icons, cleanup unnecessary pages * updated script with auto-icon generation * ignore translations, only icons changed * updated images * updated i18n.lock * updated images
287 lines
10 KiB
Plaintext
287 lines
10 KiB
Plaintext
---
|
||
title: Reddit
|
||
description: 访问 Reddit 数据和内容
|
||
---
|
||
|
||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||
|
||
<BlockInfoCard
|
||
type="reddit"
|
||
color="#FF5700"
|
||
/>
|
||
|
||
{/* MANUAL-CONTENT-START:intro */}
|
||
[Reddit](https://www.reddit.com/) 是一个社交平台，用户可以在基于主题的社区（称为 subreddit）中分享和讨论内容。
|
||
|
||
在 Sim 中，您可以使用 Reddit 集成功能来：
|
||
|
||
- **获取帖子**：从任何 subreddit 中检索帖子，并提供排序选项（热门、新帖、顶帖、上升）以及按时间筛选顶帖（今天、本周、本月、今年、所有时间）。
|
||
- **获取评论**：从特定帖子中获取评论，并提供排序和设置评论数量的选项。
|
||
|
||
这些操作使您的代理能够访问和分析 Reddit 内容，作为自动化工作流程的一部分。
|
||
{/* MANUAL-CONTENT-END */}
|
||
|
||
## 使用说明
|
||
|
||
将 Reddit 集成到工作流程中。阅读帖子、评论和搜索内容。提交帖子、投票、回复、编辑以及管理您的 Reddit 账户。
|
||
|
||
## 工具
|
||
|
||
### `reddit_get_posts`
|
||
|
||
通过不同的排序选项从 subreddit 中获取帖子
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `subreddit` | string | 是 | 要获取帖子内容的 subreddit 名称（不包括 r/ 前缀） |
|
||
| `sort` | string | 否 | 帖子排序方法："hot"、"new"、"top" 或 "rising"（默认值："hot"） |
|
||
| `limit` | number | 否 | 返回的最大帖子数量（默认值：10，最大值：100） |
|
||
| `time` | string | 否 | "top" 排序帖子使用的时间筛选器："day"、"week"、"month"、"year" 或 "all"（默认值："day"） |
|
||
| `after` | string | 否 | 用于分页的项目后续 fullname |
|
||
| `before` | string | 否 | 用于分页的项目之前 fullname |
|
||
| `count` | number | 否 | 列表中已查看项目的计数（用于编号） |
|
||
| `show` | string | 否 | 显示通常会被过滤的项目（例如："all"） |
|
||
| `sr_detail` | boolean | 否 | 在响应中展开 subreddit 详细信息 |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `subreddit` | string | 获取帖子的 subreddit 名称 |
|
||
| `posts` | array | 包含标题、作者、URL、评分、评论数量和元数据的帖子数组 |
|
||
|
||
### `reddit_get_comments`
|
||
|
||
从特定的 Reddit 帖子中获取评论
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `postId` | string | 是 | 要获取评论的 Reddit 帖子 ID |
|
||
| `subreddit` | string | 是 | 帖子所在的 subreddit（不包括 r/ 前缀） |
|
||
| `sort` | string | 否 | 评论排序方法："confidence"、"top"、"new"、"controversial"、"old"、"random"、"qa"（默认值："confidence"） |
|
||
| `limit` | number | 否 | 返回的最大评论数量（默认值：50，最大值：100） |
|
||
| `depth` | number | 否 | 线程中子树的最大深度（控制嵌套评论级别） |
|
||
| `context` | number | 否 | 包含的父评论数量 |
|
||
| `showedits` | boolean | 否 | 显示评论的编辑信息 |
|
||
| `showmore` | boolean | 否 | 在响应中包含 "加载更多评论" 元素 |
|
||
| `showtitle` | boolean | 否 | 在响应中包含提交标题 |
|
||
| `threaded` | boolean | 否 | 以线程/嵌套格式返回评论 |
|
||
| `truncate` | number | 否 | 截断评论深度的整数 |
|
||
| `after` | string | 否 | 用于分页的项目后续 fullname |
|
||
| `before` | string | 否 | 用于分页的项目之前 fullname |
|
||
| `count` | number | 否 | 列表中已查看项目的计数（用于编号） |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `post` | object | 帖子信息，包括 ID、标题、作者、内容和元数据 |
|
||
|
||
### `reddit_get_controversial`
|
||
|
||
从 subreddit 获取有争议的帖子
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `subreddit` | string | 是 | 要从中获取帖子的 subreddit 名称（不带 r/ 前缀） |
|
||
| `time` | string | 否 | 有争议帖子的时间筛选："hour"、"day"、"week"、"month"、"year" 或 "all"（默认："all"） |
|
||
| `limit` | number | 否 | 返回帖子的最大数量（默认：10，最大：100） |
|
||
| `after` | string | 否 | 用于分页的项目后面的完整名称 |
|
||
| `before` | string | 否 | 用于分页的项目前面的完整名称 |
|
||
| `count` | number | 否 | 列表中已查看项目的计数（用于编号） |
|
||
| `show` | string | 否 | 显示通常会被过滤的项目（例如："all"） |
|
||
| `sr_detail` | boolean | 否 | 在响应中展开 subreddit 详细信息 |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `subreddit` | string | 获取帖子的 subreddit 名称 |
|
||
| `posts` | array | 包含标题、作者、URL、评分、评论数量和元数据的有争议帖子数组 |
|
||
|
||
### `reddit_search`
|
||
|
||
在 subreddit 中搜索帖子
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `subreddit` | string | 是 | 要搜索的 subreddit 名称（不带 r/ 前缀） |
|
||
| `query` | string | 是 | 搜索查询文本 |
|
||
| `sort` | string | 否 | 搜索结果的排序方法："relevance"、"hot"、"top"、"new" 或 "comments"（默认值："relevance"） |
|
||
| `time` | string | 否 | 搜索结果的时间筛选："hour"、"day"、"week"、"month"、"year" 或 "all"（默认值："all"） |
|
||
| `limit` | number | 否 | 返回帖子的最大数量（默认值：10，最大值：100） |
|
||
| `restrict_sr` | boolean | 否 | 限制搜索仅在指定的 subreddit 中（默认值：true） |
|
||
| `after` | string | 否 | 用于分页的项目后续 fullname |
|
||
| `before` | string | 否 | 用于分页的项目之前 fullname |
|
||
| `count` | number | 否 | 列表中已查看项目的计数（用于编号） |
|
||
| `show` | string | 否 | 显示通常会被过滤的项目（例如："all"） |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `subreddit` | string | 执行搜索的 subreddit 名称 |
|
||
| `posts` | array | 包含标题、作者、URL、评分、评论数量和元数据的搜索结果帖子数组 |
|
||
|
||
### `reddit_submit_post`
|
||
|
||
向 subreddit 提交一个新帖子（文本或链接）
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `subreddit` | string | 是 | 要发布帖子的 subreddit 名称（不包括 r/ 前缀） |
|
||
| `title` | string | 是 | 提交的标题（最多 300 个字符） |
|
||
| `text` | string | 否 | 自定义帖子的文本内容（支持 markdown） |
|
||
| `url` | string | 否 | 链接帖子的 URL（不能与文本同时使用） |
|
||
| `nsfw` | boolean | 否 | 将帖子标记为 NSFW |
|
||
| `spoiler` | boolean | 否 | 将帖子标记为剧透 |
|
||
| `send_replies` | boolean | 否 | 发送回复通知到收件箱（默认值：true） |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 帖子是否成功提交 |
|
||
| `message` | string | 成功或错误信息 |
|
||
| `data` | object | 帖子数据，包括 ID、名称、URL 和永久链接 |
|
||
|
||
### `reddit_vote`
|
||
|
||
对 Reddit 帖子或评论进行点赞、点踩或取消投票
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `id` | string | 是 | 要投票的对象全名（例如，帖子为 t3_xxxxx，评论为 t1_xxxxx） |
|
||
| `dir` | number | 是 | 投票方向：1（点赞），0（取消投票），或 -1（点踩） |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 投票是否成功 |
|
||
| `message` | string | 成功或错误信息 |
|
||
|
||
### `reddit_save`
|
||
|
||
将 Reddit 帖子或评论保存到您的已保存项目中
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `id` | string | 是 | 要保存的对象全名（例如，帖子为 t3_xxxxx，评论为 t1_xxxxx） |
|
||
| `category` | string | 否 | 保存的分类（Reddit Gold 功能） |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 保存是否成功 |
|
||
| `message` | string | 成功或错误信息 |
|
||
|
||
### `reddit_unsave`
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `subreddit` | string | Subreddit 名称 |
|
||
| `posts` | json | 帖子数据 |
|
||
| `post` | json | 单个帖子数据 |
|
||
| `comments` | json | 评论数据 |
|
||
|
||
### `reddit_reply`
|
||
|
||
为 Reddit 帖子或评论添加回复
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `parent_id` | string | 是 | 要回复的对象全名（例如，帖子为 t3_xxxxx，评论为 t1_xxxxx） |
|
||
| `text` | string | 是 | 以 markdown 格式编写的评论文本 |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 回复是否成功发布 |
|
||
| `message` | string | 成功或错误信息 |
|
||
| `data` | object | 评论数据，包括 ID、名称、永久链接和正文 |
|
||
|
||
### `reddit_edit`
|
||
|
||
编辑您自己的 Reddit 帖子或评论的文本
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `thing_id` | string | 是 | 要编辑的事物完整名称（例如，帖子为 t3_xxxxx，评论为 t1_xxxxx） |
|
||
| `text` | string | 是 | 新的文本内容，支持 markdown 格式 |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 编辑是否成功 |
|
||
| `message` | string | 成功或错误信息 |
|
||
| `data` | object | 更新后的内容数据 |
|
||
|
||
### `reddit_delete`
|
||
|
||
删除您自己的 Reddit 帖子或评论
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `id` | string | 是 | 要删除的事物完整名称（例如，帖子为 t3_xxxxx，评论为 t1_xxxxx） |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 删除是否成功 |
|
||
| `message` | string | 成功或错误信息 |
|
||
|
||
### `reddit_subscribe`
|
||
|
||
订阅或取消订阅一个 subreddit
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `subreddit` | string | 是 | subreddit 的名称（不带 r/ 前缀） |
|
||
| `action` | string | 是 | 要执行的操作："sub" 表示订阅，"unsub" 表示取消订阅 |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 订阅操作是否成功 |
|
||
| `message` | string | 成功或错误信息 |
|
||
|
||
## 注意事项
|
||
|
||
- 类别：`tools`
|
||
- 类型：`reddit`
|