medium-sub

Fetches Medium recommended-article candidates grouped by tag as JSON output via Node.js and Playwright Chrome profile mode.

4.7k|260|Updated Dec 29, 2021
One-click install
npx skills add https://github.com/beatai-org/beatai --skill medium-sub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: medium-sub
Source: https://github.com/beatai-org/beatai/tree/main/.claude/skills/medium-sub
Command: npx skills add https://github.com/beatai-org/beatai --skill medium-sub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, and includes scripts (resource) components.

What problem does it solve?

Medium recommended pages are hard to scrape manually across many tags, and you need a clean, structured candidate list quickly for downstream processing.

Core Features & Use Cases

  • Tag-based recommended fetch: Retrieves candidate articles from https://medium.com/tag/<tag>/recommended for a configured set of Medium tag slugs.
  • Deterministic stdout JSON output: Emits a single JSON document to stdout containing per-tag grouped article cards (title, cleaned URL, published date, author).
  • Fetch-only scope for pipelines: Designed to be a pure fetcher that does not write files, apply daily limits, or cross-day deduplication—those responsibilities belong to the caller (e.g., material-pipeline).

Quick Start

Ask the system to run medium-sub with tags ai,llm and print the resulting candidate JSON to stdout.

Frequently Asked Questions about medium-sub

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape Medium recommended articles for multiple tags?

To scrape Medium recommended articles for multiple tags, use a Playwright-based fetcher to retrieve candidate lists from medium.com/tag/<tag>/recommended and group metadata by tag. This approach extracts titles, cleaned URLs, published dates, and authors without downloading full articles.

What's the best way to get structured JSON from Medium tag pages?

The best way to get structured JSON from Medium tag pages is running a Playwright-based fetcher that emits a single clean JSON object to stdout. It groups article cards by tag, keeping logs separate on stderr for clean pipeline ingestion.

Do I need Node.js and Playwright to fetch Medium article listings?

Yes, you need Node.js with Playwright installed in Chrome persistent-profile mode to fetch Medium article listings. This environment is required to automate browser interactions and extract candidate article metadata from dynamic Medium recommended pages.

Can I limit the number of articles fetched per Medium tag?

Yes, you can limit the number of articles fetched per Medium tag by passing an optional max-per-tag argument. This allows you to control the volume of candidate articles retrieved for each tag before the structured JSON is emitted to stdout.

Does this Medium scraper handle cross-day deduplication and file persistence?

No, this Medium scraper does not handle cross-day deduplication or file persistence. It is designed as a pure fetcher that outputs JSON to stdout, leaving deduplication, daily limits, and file writing responsibilities to the downstream caller pipeline.

How do I integrate Medium scraped data into a content pipeline?

To integrate Medium scraped data into a content pipeline, capture the JSON object emitted to stdout by the fetcher. The caller pipeline can then process the grouped article metadata to apply deduplication, archiving, and downstream content analysis.