安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install substack-research
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 substack-research。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Substack Research 可帮助 AI 代理发现新闻简报和作者，查看范围有限的公开作品样本，并收集证据，以便整理出版物候选清单或报道简报。它会在可用时使用 Crawlora MCP 工具，或使用随附的 shell 脚本访问 Substack 研究端点。
此技能强调可追溯且范围经过谨慎界定的研究：保留来源 URL、标识符、采集时间和样本量；区分出版物身份与作者身份；并将观察到的报道范围与推断分开。Openclaw Skills 用户可以借此探索公开的 Substack 内容，但不应将人气指标视为经过审计的收入或具有代表性的观点。

应用场景

查找指定主题（例如气候政策）相关的公开新闻简报和作者。
使用抽样帖子和主题契合度证据比较出版物及其编辑报道范围。
查看出版物档案、选定的公开帖子内容、投稿者或推荐内容。
浏览出版物类别和排行榜，同时明确类别范围以及免费/付费范围。
抽样查看公开 Notes、回复或 restacks，并保留分页上下文。
准备带有来源链接的出版物或作者候选清单、研究简报或报道范围概览。

工作原理

设置 Crawlora 访问权限，并查阅端点参考资料，了解支持的工具、方法和参数。
搜索出版物或用户，然后保留返回的标识符，并区分出版物身份与作者身份。
浏览类别页面或排行榜之前，先发现类别；为每个端点使用适当的标识符和分页方法。
仅获取相关的出版物详情、帖子样本、投稿者、推荐内容、用户活动或 Notes。对于分页的 Notes、回复和 restacks，使用 next_cursor 继续获取。
同时检查 HTTP 状态和应用程序 code；从 data 中读取结果。遇到身份验证错误时停止，遇到 429 时退避等待，暂时性的上游故障仅重试一次。
提供范围有限的研究简报，其中包含 URL、日期、采集时间、样本量、公开摘录，并清楚区分证据与推断。

配置指南

将 CRAWLORA_API_KEY 设置为你的 Crawlora API 密钥。
连接后优先使用具名 Crawlora MCP 工具。否则，使用随附的 scripts/crawlora.sh 客户端；该客户端会将密钥通过 x-api-key 发送到 https://api.crawlora.net/api/v1。
阅读 reference/endpoints.md，了解确切的工具名称、方法和参数。
运行发现请求，并使用返回的出版物 ID、slug 或其他标识符进行后续调用。根据请求范围和额度限制调用次数及页面数量。
export CRAWLORA_API_KEY="your-crawlora-api-key"
scripts/crawlora.sh /substack/search query="climate policy"
scripts/crawlora.sh /substack/categories
scripts/crawlora.sh /substack/notes/tabs

After discovering a publication, use its identifier and returned post slug:

scripts/crawlora.sh /substack/publication publication="$PUBLICATION"
scripts/crawlora.sh /substack/publication/posts publication="$PUBLICATION" sort=new limit=10
scripts/crawlora.sh /substack/post publication="$PUBLICATION" slug="$POST_SLUG"

数据架构

此技能未指定本地数据库或生成文件的格式。研究结果来自 Crawlora 响应，其负载包含在 data 中。整理发现内容时，请保留以下上下文：
数据区域 应保留的标识符和元数据
出版物 出版物标识符或子域名/自定义域名；与作者身份分开记录。
帖子 出版物标识符及返回的帖子 slug；包含来源 URL、日期，并注明文本是公开摘录还是完整内容。
类别和排行榜 类别 ID（数字或 podcast）、从零开始的类别页码，以及明确的免费/付费范围。出版物档案使用 offset 和 limit。
Notes 和互动 Notes 标签页 ID 及其类型（base、secondary 或 category）；保留 next_cursor，并记录每项指标所对应的内容界面。
研究采集 采集时间、样本量、来源 URL 和返回的标识符。
将无法获取的文本视为未知。公开信息流是一个快照，而非登录用户的个性化信息流；关注者数量、排行榜位置和互动反应并非经过审计的订阅收入，也不代表具有代表性的观点。

高级特性

支持具名 Crawlora MCP 工具，或使用随附的
scripts/crawlora.sh
作为后备方案。
支持对出版物档案、选定帖子、投稿者、推荐内容、作者活动、Notes、回复和 restacks 进行范围有限的抽样。
处理特定端点的标识符和分页，包括档案的
offset
/
limit
、从零开始的类别页码以及 Notes 的
next_cursor
值。
采用操作安全措施：除 HTTP 状态外还要检查应用程序代码；遇到身份验证错误时停止；遇到
时退避等待；暂时性的上游故障仅重试一次。
通过保留 URL、标识符、采集时间和样本量，并将观察到的报道范围与推断分开，确保来源可追溯且分析细致。
避免执行未经请求的外部操作：除非用户提出要求，否则不要订阅、评论、给作者发消息或关注账号。

name: substack-research description: Research Substack publications, writers, public posts, recommendations, categories, and Notes through Crawlora. Use to find newsletters, compare editorial coverage, inspect a publication archive, or sample public discussion and writer networks.

Substack publication and Notes research

Access and contract

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the named Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact tool names, methods, and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound pages and calls by the requested scope and credit budget. Preserve source URLs, identifiers, and collection times.

Find public newsletters and writers, then inspect bounded samples of their published work and discussion. Use publication identity separately from writer identity; one writer may contribute to multiple publications.

Discover and follow returned identities

Search publications or users with their respective tools. Publication detail requires either publication (subdomain/custom domain) or publication_id; supply one despite the schema marking both individually optional. Posts use a publication identifier plus a returned post slug, not a user handle alone.
Discover categories before category browsing or leaderboards. Category IDs can be numeric or podcast; keep free/paid leaderboard scope explicit. Category pages are zero-based, while publication archives use offset and limit.
Fetch publication posts, selected public post content, contributors, and recommendations only as relevant. Recommendations require the numeric publication ID; a recommendation or user connection does not establish a commercial relationship, endorsement of every article, or common ownership.
Notes tabs return a paired tab ID and type (base, secondary, category). Preserve the pair. Follow next_cursor for Notes, replies, or restacks; small variable pages do not imply pagination has ended.
User detail/activity/connections and Notes/replies/restacks use their own returned identifiers. Preserve which surface produced each engagement metric.
scripts/crawlora.sh /substack/search query="climate policy"
scripts/crawlora.sh /substack/categories
scripts/crawlora.sh /substack/notes/tabs

# Use a discovered publication and post slug, for example:
# scripts/crawlora.sh /substack/publication publication="$PUBLICATION"
# scripts/crawlora.sh /substack/publication/posts publication="$PUBLICATION" sort=new limit=10
# scripts/crawlora.sh /substack/post publication="$PUBLICATION" slug="$POST_SLUG"

Interpret and deliver

Return a publication/writer shortlist or coverage brief with topic-fit evidence, public excerpts, URLs, dates, collection time, and sample size. Distinguish a paid-content preview from the full article and leave unavailable text unknown. A public feed is a snapshot, not the signed-in user's personalised feed. Leaderboard positions, follower counts, or reactions are not audited subscriber revenue or representative opinion. Attribute claims to their authors and separate coverage observations from inference. Do not subscribe, comment, message writers, or follow accounts unless the user requests those actions.

航班行程比较
Newsletter 主题版图