用途:通过 Crawlora 访问 Substack 公开数据,研究出版物、作者、公开文章、推荐、分类和 Notes,适合查找 newsletter、比较编辑方向、梳理作者与出版物的公开作品和讨论。
接入方式:设置 CRAWLORA_API_KEY 为你的 Crawlora 密钥。已连接时优先使用 Crawlora MCP 具名工具,否则使用随附的 scripts/crawlora.sh,它会向 https://api.crawlora.net/api/v1 发送 x-api-key。工具名、方法与参数见 reference/endpoints.md。除 HTTP 状态外还要检查应用代码,payload 位于 data 内。认证错误应停止,429 应退避,瞬时上游失败重试一次。按请求范围和额度预算限制分页与调用次数。保留来源 URL、标识符和采集时间。
主要能力:搜索出版物或用户;获取出版物详情、文章、部分公开文章内容、贡献者和推荐;浏览分类与排行榜;读取 Notes 的选项卡、回复和 restack;查看用户详情、活动和连接。出版物详情需提供 publication(子域/自定义域)或 publication_id 之一,尽管 schema 标记两者各自可选。文章需出版物标识加返回的 post slug,不能仅凭用户 handle。分类浏览前先发现分类,分类 ID 可为数字或 podcast,排行榜需明确免费/付费范围;分类页为从零开始,出版物归档使用 offset 和 limit。推荐需数字出版物 ID。
用法示例: scripts/crawlora.sh /substack/search query="climate policy" scripts/crawlora.sh /substack/categories scripts/crawlora.sh /substack/notes/tabs 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"
交付与限制:输出出版物/作者候选清单或报道简报,含主题匹配证据、公开摘录、URL、日期、采集时间和样本量。区分付费内容预览与全文,不可得文本保留为未知。公开 feed 是快照,非登录用户个性化 feed。排行榜位置、关注数和 reaction 不代表经审计的订阅收入或代表性意见。将观点归因作者,区分观察与推断。除非用户要求,不要订阅、评论、私信作者或关注账号。