Skip to content
Skills Library
Marketing & content · Research

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.

Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
1
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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

  1. Access and contract
  2. Discover and follow returned identities
  3. Interpret and deliver
Original SKILL.md headings · 58 lines, 406 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.