substack-research
/substack-research
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.
- Author
- Crawlora-org ↗
- Repository
- crawlora-skills ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/crawlora.sh
What it does and when to use it
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.
Original author 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.
How it works
- Access and contract
- Discover and follow returned identities
- Interpret and deliver
SKILL.md preview
--- 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](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. ```sh 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.
Files in this package (3)
- SKILL.md 3 KB
- reference/endpoints.md 13 KB
- scripts/crawlora.sh 4 KB
Versions
The database has no other skills named substack-research.
Database snapshot: 13.11.2026 · package version aac316272ba6 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100newsletter-topic-landscape
Compare editorial topics and coverage across Substack newsletters through Crawlora publication discovery and bounded public post samples. Use for a newsletter landscape, publication positioning map, coverage-gap brief, or topic-focused reading shortlist without inferring readership. - 100substack
Read and publish on Substack (substack.com) with the user's own login cookies (BYOC) — show who they are and their primary publication, list their published posts with stats, and publish a new post / newsletter. Use when the user mentions Substack, "my Substack", their… - 90substack-ghostwriting
Use when asked to ghostwrite Substack newsletters and web posts from structured intake. Not for tasks that require source or remote-system changes. - 90substack-notes
Write Substack Notes that work as genuine fragments with an actual idea inside them, not miniaturized newsletters. Use for Substack Notes and similar short posts. Enforces the EW anti-AI rules and the writer's voice profile. - 100publish-substack
Use when an article under articles/substack/ has to reach Substack — "publish to Substack", "put the draft on Substack", "опублікуй на сабстек", "/publish-substack <slug>" — or when a post already live on Substack needs its body replaced from the repository. Not for writing the… - 100substack-growth-audit
Weekly read-only audit of a Substack publication's public archive to find why growth or engagement is slipping, using fixed tests with metrics. Use when asked why posts underperform, why subscribers are not growing, for a weekly growth check, or before planning the next week of…