reddit-market-monitor

🚀 Way to AIC | 通往 AI 电商之路

---

🌐 官网 Website

• https://waytoaic.com
• https://www.waytoaic.com

---

👥 社群招募 Community

Way to AIC 社群招募 | WaytoAIC.com

---

📣 公众号 WeChat Official Account

维正 WaytoAIC

---

🧠 知识星球 Xiaozhixing

AI电商之路 WaytoAIC

---

🧩 About Way to AIC

AIC = AI Commerce

在 AI 重塑商业的时代，我们希望和每一个拥抱 AI 的卖家：

• 找到场景
• 定义问题
• 积累能力
• 设计系统

共同通往 AI 电商之路。

Way to AIC 不是教学，不是工具，
而是一条所有电商人共同走的进化之路。

WaytoAIC 理念 | Principles

---

中文 | English

Quick Install

# Codex
curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/v1.4.0/install.sh | bash -s -- --target codex --ref v1.4.0

# OpenClaw
curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/v1.4.0/install.sh | bash -s -- --target openclaw --ref v1.4.0

# OpenClaw workspace-local skills/
curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/v1.4.0/install.sh | bash -s -- --dest "$(pwd)/skills" --ref v1.4.0

复制即用。安装后重启 Codex / OpenClaw。

---

一个面向产品开发与运营决策的 Reddit 市场监控 Skill。

它不是热帖搬运器，而是一个把 Reddit 讨论转成：

• 产品开发动作
• 运营动作
• 竞品观察
• 用户原声存档
• 日报 / 周报 / 多组总览

的结构化技能包。

中文

适用场景

• Reddit 市场监控
• subreddit 监控
• Reddit VOC / 用户原声沉淀
• 竞品监控
• 用户痛点、功能诉求、购买顾虑挖掘
• 把 Reddit 讨论转成产品开发、运营、FAQ、内容、客服动作

仓库内容

• 主 Skill 入口：SKILL.md
• 完整执行规则：skills.md
• 默认配置与 schema：config.yaml
• 新手配置模板：templates/monitor_task_config.template.yaml
• 日报与原声存档：运行时写到 reports/、archives/，属于使用者自己的数据，不进仓库
• 内置 Reddit 只读子技能：skills/reddit-readonly

主要特点

• 内置 reddit-readonly 子技能，用户无需额外安装第二个 skill
• 支持多组监控，但推荐按“一个监控任务对应一个 config”来组织
• 输出默认表格优先，更适合日报、周报和决策面板阅读
• 报告产物支持 md 或 md+html（首次使用询问一次；HTML 为自包含单文件，permalink 自动可点、优先级自动着色）
• 支持长期 VOC 存档、主题记忆、偏好学习

安装

把整个目录复制到：

~/.codex/skills/reddit-market-monitor

重启 Codex 后即可生效。

一键安装

适用于直接从 GitHub 安装最新版。

Codex:

curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/main/install.sh | bash -s -- --target codex

OpenClaw 全局 skills 目录:

curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/main/install.sh | bash -s -- --target openclaw

OpenClaw 工作区本地 skills/ 目录:

curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/main/install.sh | bash -s -- --dest "$(pwd)/skills"

固定到某个 tag 或版本:

curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/v1.4.0/install.sh | bash -s -- --target codex --ref v1.4.0

推荐使用方式

1. 如果你还没有明确监控策略，先从 templates/monitor_task_config.template.yaml 生成一个最小可跑的 task config。
2. 一个监控任务只服务一个明确业务目标。
3. 新任务先从 1 个 monitor_group 开始，跑通后再扩展。
4. 报告默认优先输出表格，而不是大段散文。

许可说明

本仓库采用“公开源码 / source-available”授权，而不是 OSI 定义下的 Open Source。

原因很简单：

• 本项目允许学习、使用、修改与分享
• 但不允许商业使用
• 如果你基于本 Skill 做修改、派生版本，或用它开发并分发更大的功能，也必须公开对应源代码

具体条款见：

• LICENSE.md
• ADDITIONAL_TERMS.md

如果你需要商业授权，请联系作者单独协商。

仓库结构

.
├── SKILL.md
├── skills.md
├── config.yaml
├── templates/
├── reports/      # 运行时生成，不进仓库
├── archives/     # 运行时生成，不进仓库
└── skills/
    └── reddit-readonly/

数据后端说明（重要）

Reddit 已于 2026 年 5 月停用匿名 .json 端点，数据中心 IP 直连会返回 HTTP 403。内置 reddit-readonly 子技能（v1.5.0）按能力在 6 个后端间路由——各后端强项互不重叠，按查询类型选第一顺位；某个后端报错或数据过旧（新鲜度闸门）就自动换下一个。data.source 标注实际答题的后端，data.backend_trail 标注走过的路。

• 零配置可用：rss + arctic 覆盖全部命令；其他 key 只加能力，不是必需。
• 全站搜索的顺位：sorftime → rss → tikhub → serpapi（配了官方 OAuth 则官方在最前）。
• --postType / --sentiment 只有 Sorftime 能做，没配 key 会直接报错，不会悄悄返回没筛过的结果。
• Sorftime 的 voc_tags.summary 是 AI 写的摘要，不是用户原话；原声存档请用 thread 拉全文和评论。
• 可用 REDDIT_RO_BACKEND=auto|reddit|rss|arctic|tikhub|serpapi|sorftime 强制指定后端（默认 auto）。
• 先跑 node skills/reddit-readonly/scripts/reddit-readonly.mjs doctor，看哪些后端真的通。
• 合规：Reddit Responsible Builder Policy 禁止把 Reddit 数据用于商业挖掘或训练 AI，无论经由哪个数据源；第三方源（Sorftime / TikHub）的合规责任由提供 key 的人承担。

说明

• reddit-readonly.zip 与 skills/reddit-readonly/ 目录中的内置子技能保持同步，主 Skill 实际调用目录版本。
• 当前仓库 README 顶部已加入 Way to AIC 固定项目前缀，后续 Way to AIC 项目可复用同一前缀模板。

---

English

Quick Install Card

# Codex
curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/v1.4.0/install.sh | bash -s -- --target codex --ref v1.4.0

# OpenClaw
curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/v1.4.0/install.sh | bash -s -- --target openclaw --ref v1.4.0

# OpenClaw workspace-local skills/
curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/v1.4.0/install.sh | bash -s -- --dest "$(pwd)/skills" --ref v1.4.0

Copy, run, then restart Codex / OpenClaw.

---

reddit-market-monitor is a Reddit monitoring skill designed for product, growth, and operations decisions.

It is not a repost bot. It turns Reddit discussions into:

• product actions
• operations actions
• competitor watch
• user voice archive
• daily reports, weekly reports, and multi-group summaries

Use Cases

• Reddit market monitoring
• subreddit monitoring
• VOC and user-language capture from Reddit
• competitor monitoring
• finding pain points, feature requests, and buying objections
• converting Reddit discussions into actions for product, FAQ, support, content, and operations

What Is Included

• Main skill entry: SKILL.md
• Full execution rules: skills.md
• Default config and schema: config.yaml
• Starter config template: templates/monitor_task_config.template.yaml
• Daily reports and the user-voice archive are written to reports/ and archives/ at run time; they are your own data and are not tracked in the repo
• Bundled read-only Reddit subskill: skills/reddit-readonly

Key Features

• Bundles reddit-readonly, so users do not need to install a second skill
• Supports multi-group monitoring, while recommending one config per monitoring task
• Uses table-first output for easier reading in daily and weekly decision workflows
• Reports export as md or md+html (asked once on first use; HTML is a self-contained single file with clickable permalinks and priority coloring)
• Supports long-term VOC archiving, theme memory, and preference learning

Installation

Copy this directory to:

~/.codex/skills/reddit-market-monitor

Then restart Codex.

One-Command Install

Use these commands to install the latest version directly from GitHub.

Codex:

curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/main/install.sh | bash -s -- --target codex

OpenClaw global skills directory:

curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/main/install.sh | bash -s -- --target openclaw

OpenClaw workspace-local skills/ directory:

curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/main/install.sh | bash -s -- --dest "$(pwd)/skills"

Pin to a tag or version:

curl -fsSL https://raw.githubusercontent.com/WaytoAIC/reddit-market-monitor/v1.4.0/install.sh | bash -s -- --target codex --ref v1.4.0

Recommended Workflow

1. If you do not yet have a monitoring strategy, start from templates/monitor_task_config.template.yaml.
2. Keep one config focused on one clear business goal.
3. Start new tasks with a single monitor_group, then expand later if needed.
4. Prefer table-first reporting instead of long narrative output.

License

This repository is released as public source-available software, not OSI-defined Open Source.

That is because it is intended to be:

• usable for learning, internal use, modification, and sharing
• not permitted for commercial use
• required to publish source code for derivative or larger distributed functionality built from it

See:

• LICENSE.md
• ADDITIONAL_TERMS.md

If you need a commercial license, contact the author separately.

Repository Layout

.
├── SKILL.md
├── skills.md
├── config.yaml
├── templates/
├── reports/      # created at run time, not tracked
├── archives/     # created at run time, not tracked
└── skills/
    └── reddit-readonly/

Data Backend (Important)

Reddit deprecated its anonymous .json endpoints in May 2026; datacenter IPs now get HTTP 403. The bundled reddit-readonly subskill (v1.5.0) routes by capability across 6 backends — their strengths do not overlap, so the first choice depends on the query; a backend that errors or returns stale data (freshness gate) hands over to the next. data.source names who answered, data.backend_trail the route taken.

• Zero config works: rss + arctic cover every command; keys only add capabilities.
• All-Reddit search order: sorftime → rss → tikhub → serpapi (the official API leads when configured).
• --postType / --sentiment exist only on Sorftime; without the key the command fails loudly instead of returning unfiltered rows.
• Sorftime’s voc_tags.summary is AI-written, not the user’s words; pull thread for quotable text.
• REDDIT_RO_BACKEND=auto|reddit|rss|arctic|tikhub|serpapi|sorftime forces a backend (default auto).
• Run node skills/reddit-readonly/scripts/reddit-readonly.mjs doctor first to see which backends actually answer.
• Compliance: Reddit’s Responsible Builder Policy forbids commercial mining or AI training on Reddit data regardless of source; compliance for third-party sources (Sorftime / TikHub) rests with whoever supplies the key.

Note

• reddit-readonly.zip is kept in sync with the bundled subskill under skills/reddit-readonly/; the main skill calls the directory version.
• This repository now includes the fixed Way to AIC README prefix at the top, intended for reuse across future Way to AIC GitHub projects.