Media and Entertainment

Marginal Revolution

pp-marginalrevolution

Read, filter, and extract links from Marginal Revolution through its public RSS feed

Printed by @hinuri (Nuri Chang)

Install

npx — recommended

npx -y @mvanhorn/printing-press-library install marginalrevolution

Installs the CLI binary and the agent skill (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more). Add --cli-only or --skill-only for one half. Requires Node.

Hermes

hermes skills install mvanhorn/printing-press-library/cli-skills/pp-marginalrevolution --force

From the Hermes CLI. Inside a chat session use /skills install with the same path.

OpenClaw

Install the pp-marginalrevolution skill from https://github.com/mvanhorn/printing-press-library/tree/main/cli-skills/pp-marginalrevolution. The skill defines how its required CLI can be installed.

Paste this to your OpenClaw agent — the skill describes how to install its CLI.

Claude Desktop

This CLI ships an MCPB bundle. Download the latest release .mcpb and double-click it — Claude Desktop walks you through the install.

View source on GitHub →

Read and filter Marginal Revolution from the command line through its public RSS feed.

This CLI was regenerated with CLI Printing Press 4.2.1. It keeps the generated v4.2 agent/MCP scaffolding and adds RSS-native helper commands for posts, authors, categories, and outbound links.

Quick Start

1. Install

See Install above.

2. Verify Setup

marginalrevolution-pp-cli doctor

This checks your configuration.

3. Try Your First Command

marginalrevolution-pp-cli latest --limit 5

Usage

Run marginalrevolution-pp-cli --help for the full command reference and flag list.

Commands

feed

Manage feed

marginalrevolution-pp-cli feed get - Returns the current public RSS feed. The feed is XML/RSS and does not require authentication.

RSS-native helpers

marginalrevolution-pp-cli latest - list recent posts with dates, authors, categories, comment counts, and canonical URLs
marginalrevolution-pp-cli search <query> - search current-feed title, excerpt, body text, author, and category text
marginalrevolution-pp-cli read <url|guid|title> - read the body text for a post currently present in the feed
marginalrevolution-pp-cli links - extract outbound cited links from recent posts
marginalrevolution-pp-cli categories - show current-feed category counts
marginalrevolution-pp-cli authors - show current-feed author counts

Scope

The public RSS feed is available to command-line clients. Marginal Revolution's WordPress JSON API and normal site-search URL returned Cloudflare browser challenges during implementation, so this CLI intentionally keeps search scoped to posts currently present in the feed.

Output Formats

# Human-readable table (default in terminal, JSON when piped)
marginalrevolution-pp-cli latest

# JSON for scripting and agents
marginalrevolution-pp-cli latest --json

# Filter to specific fields
marginalrevolution-pp-cli feed --json --select id,name,status

# Dry run — show the request without sending
marginalrevolution-pp-cli feed --dry-run

# Agent mode — JSON + compact + no prompts in one flag
marginalrevolution-pp-cli search ai --agent

Agent Usage

This CLI is designed for AI agent consumption:

Non-interactive - never prompts, every input is a flag
Pipeable - --json output to stdout, errors to stderr
Filterable - --select id,name returns only fields you need
Previewable - --dry-run shows the request without sending
Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
Offline-friendly - sync/search commands can use the local SQLite store when available
Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.

Health Check

marginalrevolution-pp-cli doctor

Verifies configuration and connectivity to the API.

Configuration

Config file: ~/.config/marginal-revolution-pp-cli/config.toml

Static request headers can be configured under headers; per-command header overrides take precedence.

Troubleshooting

Not found errors (exit code 3)

Check the resource ID is correct
Run the list command to see available items

Generated by CLI Printing Press