← 返回 Skills 市场
huojiecs110

Fapi Reddit

作者 huojiecs110 · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
337
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install fapi-reddit
功能描述
通过自然语言调用 fapi.uk 提供的 Reddit API,实现用户、子版块帖子查询和搜索等功能,无需手动组装参数。
使用说明 (SKILL.md)

fapi.uk Reddit 全能 API Skill(纯 REST 版)

作者:@huojiecs110
版本:1.1.0
类别:Social / Reddit
官网:https://fapi.uk
文档:https://utools.readme.io

这是什么

这个 Skill 让小龙虾通过自然语言完整使用 fapi.uk 的 Reddit API(共 7 个真实接口)。
完全不需要 MCP,小龙虾会自己阅读本文件,智能选择对应接口、组装参数、发送 POST 请求,并用自然中文总结结果。

Base URLhttps://fapi.uk/api/base/apitools/reddit/

必须先完成一次设置(30 秒)

  1. 打开 https://fapi.ukhttps://utools.readme.ioTwitter / Google 一键登录
  2. 在仪表盘生成 API Key(建议命名为 “OpenClaw 小龙虾”)
  3. 在 OpenClaw 中设置(强烈推荐): openclaw config set skills.entries.fapi-reddit.apiKey "你的完整apiKey"

或者直接在聊天里说: “我的 fapi apiKey 是 xxx,我的 auth_token 是 yyy”

核心调用规则(小龙虾必须严格遵守)

  1. 每次行动前 先调用余额查询接口,检查积分是否足够
  2. 所有请求 必须 在url 参数中携带 apiKey`
  3. 积分不足时立即停止,回复用户并给出充值链接
  4. 返回结果后,用自然流畅的中文总结关键信息,不要直接贴原始 JSON(用户要求“原始数据”时再给)
  5. 支持 proxyUrl 参数(需要时可问用户要代理)

主要功能模块(小龙虾会自动选择对应接口)

  1. 用户相关(User)userPostsTop(用户热门/置顶帖子,支持时间筛选) userPostsNew(用户最新帖子) userPostsHot(用户热帖) userActivity(用户最近动态,包含帖子和评论)

  2. 子版块相关(Subreddit)subredditTop(子版块置顶/精华帖子,支持 hour/day/week/month/year/all) subredditNew(子版块最新帖子) subredditHot(子版块热门帖子)

  3. 搜索与详情(Search & Detail) search(全站或指定子版块搜索,支持 relevance/hot/top/new/comments 排序 + 时间筛选) postDetail(获取单条帖子完整详情 + 所有评论,需要 subreddit 和 article id)

积分与付费说明

  • 每次调用 reddit 接口会从你的 fapi.uk 账户扣除积分
  • 积分不足此服务会返回 "You have made too many requests. Please contact the administrator to upgrade the frequency limit. "
  • 小龙虾不会自动购买积分(OpenClaw 安全策略禁止自动支付)
  • 积分不足时我会主动告诉你,并给出 https://fapi.uk/pay 充值链接
  • 建议提前充值积分,避免中断
  • 注意如果调用 MCP接口 使用自己的代理AI 配置 则只扣除1积分,否则MCP接口每次将会消耗100积分

如何设置 apiKey(只需做一次)

  1. 登录 https://fapi.uk (支持 Twitter/Google 一键登录)
  2. 前往 https://fapi.uk/api-keys 生成 Key , 并赠送100积分用于测试
  3. 在 OpenClaw 里执行: openclaw config set skills.entries.fapi-uk.apiKey "你的key"
安全使用建议
Before installing: 1) Confirm how and where the fapi.uk API key will be stored — prefer using the OpenClaw config entry (set once) over pasting keys in chat. 2) Ask the skill author to declare the required credential(s) in the metadata (primaryEnv) so you know exactly what is needed. 3) Request that the skill use Authorization headers instead of putting the apiKey in URL query parameters (URLs may be logged or leaked via Referer). 4) Verify which config key is correct (fapi-reddit vs fapi-uk) and that OpenClaw stores the key encrypted/with limited ACLs. 5) Be cautious with proxy usage — a proxy can see full request/response content. 6) Check fapi.uk's trustworthiness, billing model, and revoke the API key if you suspect leakage. If you need help confirming secure storage or modifying the skill to use headers rather than URL params, get the author to update the SKILL.md and metadata first.
功能分析
Type: OpenClaw Skill Name: fapi-reddit Version: 1.0.2 The skill is a REST API wrapper for the fapi.uk service, designed to allow the agent to interact with Reddit (searching posts, viewing user activity, etc.). It requires a user-provided API key and routes requests to https://fapi.uk/api/base/apitools/reddit/. While it involves a third-party intermediary and requests credentials (apiKey and auth_token) to function, there is no evidence of malicious intent, exfiltration of sensitive local system data, or harmful prompt injection.
能力评估
Purpose & Capability
The SKILL.md describes a straightforward wrapper for fapi.uk's Reddit endpoints, which matches the skill name/description. However there are small but relevant inconsistencies: the SKILL.md shows two different OpenClaw config keys (skills.entries.fapi-reddit.apiKey vs skills.entries.fapi-uk.apiKey), and it also references an optional auth_token not declared anywhere in the registry metadata. These mismatches suggest sloppy metadata or incomplete declaration of required secrets.
Instruction Scope
The runtime instructions tell the agent to call fapi.uk endpoints and to always check account balance before each action — that's consistent with a paid API. But they also require including the apiKey in URL parameters (query string) and say users may paste apiKey/auth_token into chat. Putting secrets in URLs and chat increases the risk of accidental exposure (logs, referers, chat history). The instructions also encourage storing the key in OpenClaw config without describing secure storage/permissions. There is no instruction to avoid reading unrelated local files, so scope creep isn't evident, but secret-handling guidance is weak and risky.
Install Mechanism
This is an instruction-only skill with no install spec or code files. That minimizes filesystem/install risk — the skill will only make outbound HTTP calls per its instructions.
Credentials
The registry declares no required environment variables or primary credential, yet the SKILL.md clearly requires an apiKey (and optionally an auth_token) to be provided and suggests persisting it in OpenClaw config. That mismatch is important: the skill will not function without secrets, but the metadata doesn't declare them. Also, the instruction to put the apiKey in URL query parameters is a disproportionate (and insecure) way to supply credentials compared with using Authorization headers.
Persistence & Privilege
The skill suggests storing the apiKey in OpenClaw config (skills.entries.*). Persisting the key for future calls is reasonable for this use case, and 'always' is false. The risk is that the SKILL.md does not clarify storage protection or the correct config key name (inconsistent key names were provided), which could cause accidental misconfiguration or leakage.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install fapi-reddit
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /fapi-reddit 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
- 修正文档中 apiKey 的配置路径,统一为 skills.entries.fapi-reddit.apiKey - 文件内容调整为与实际技能名称(fapi-reddit)一致 - 其它说明和接口使用方式保持不变
v1.0.1
- Removed the redundant README.md file. - Simplified the SKILL.md setup instructions by omitting advanced authentication parameters (auth_token, ct0), streamlining initial configuration. - Minor cleanup in SKILL.md for setup and usage rules.
v1.0.0
- Initial release of the fapi.uk Reddit REST API skill. - Enables full use of 7 major Reddit API interfaces via natural language. - No MCP required; API key and authentication setup needed to access endpoints. - Supports user info, subreddit browsing, search, and detailed post/comment retrieval. - Requires checking account balance before each action and clear user feedback if insufficient credits. - Responses are summarized in fluent, user-friendly Chinese.
元数据
Slug fapi-reddit
版本 1.0.2
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

Fapi Reddit 是什么?

通过自然语言调用 fapi.uk 提供的 Reddit API,实现用户、子版块帖子查询和搜索等功能,无需手动组装参数。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 337 次。

如何安装 Fapi Reddit?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install fapi-reddit」即可一键安装,无需额外配置。

Fapi Reddit 是免费的吗?

是的,Fapi Reddit 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Fapi Reddit 支持哪些平台?

Fapi Reddit 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Fapi Reddit?

由 huojiecs110(@huojiecs110)开发并维护,当前版本 v1.0.2。

💬 留言讨论