trendhunter

Trend Hunter CLI

Every Trend Hunter feature, plus a local SQLite corpus, FTS5 search, FAQ Q&A extraction, and agent-native JSON no other Trend Hunter tool offers.

trendhunter-pp-cli scrapes the free public TrendHunter surface (RSS feed, sitemap, category and trend pages, search results) into a local SQLite store, then exposes corpus-diff, rising-keyword clusters, time-windowed author velocity, FAQ Q&A extraction, and a category-watch feed the site itself can't provide. No API key. No login. Stdlib HTTP transport - no headless browser.

Learn more at Trend Hunter.

Created by @mvanhorn (Matt Van Horn).

Install

The recommended path installs both the trendhunter-pp-cli binary and the pp-trendhunter agent skill (Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, and other agents supported by the upstream skills CLI) in one shot:

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

For CLI only (no skill):

npx -y @mvanhorn/printing-press-library install trendhunter --cli-only

For skill only — installs the skill into the same agents as the default command above, but skips the CLI binary (use this to update or reinstall just the skill):

npx -y @mvanhorn/printing-press-library install trendhunter --skill-only

To constrain the skill install to one or more specific agents (repeatable — agent names match the skills CLI):

npx -y @mvanhorn/printing-press-library install trendhunter --agent claude-code
npx -y @mvanhorn/printing-press-library install trendhunter --agent claude-code --agent codex

Without Node (Go fallback)

If npx isn't available (no Node, offline), install the CLI directly via Go (requires Go 1.26.4 or newer):

go install github.com/mvanhorn/printing-press-library/library/marketing/trendhunter/cmd/trendhunter-pp-cli@latest

This installs the CLI only — no skill.

Pre-built binary

Download a pre-built binary for your platform from the latest release. On macOS, clear the Gatekeeper quarantine: xattr -d com.apple.quarantine <binary>. On Unix, mark it executable: chmod +x <binary>.

Install for Hermes

Install the CLI binary first. The installer writes binaries to a per-user managed bin directory by default: $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows.

npx -y @mvanhorn/printing-press-library install trendhunter --cli-only

Then install the focused Hermes skill.

From the Hermes CLI:

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

Inside a Hermes chat session:

/skills install mvanhorn/printing-press-library/cli-skills/pp-trendhunter --force

Restart the Hermes session or gateway if the newly installed skill is not visible immediately.

Install for OpenClaw

Install both the CLI binary and the focused OpenClaw skill. The installer defaults binaries to a per-user bin directory ($HOME/.local/bin on macOS/Linux, %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows):

npx -y @mvanhorn/printing-press-library install trendhunter --agent openclaw

Restart the OpenClaw session or gateway if the newly installed skill is not visible immediately.

Use with Claude Desktop

This CLI ships an MCPB bundle — Claude Desktop's standard format for one-click MCP extension installs (no JSON config required).

To install:

1. Download the .mcpb for your platform from the latest release.
2. Double-click the .mcpb file. Claude Desktop opens and walks you through the install.

Requires Claude Desktop 1.0.0 or later. Pre-built bundles ship for macOS Apple Silicon (darwin-arm64) and Windows (amd64, arm64); for other platforms, use the manual config below.

Manual JSON config (advanced)

If you can't use the MCPB bundle (older Claude Desktop, unsupported platform), install the MCP binary and configure it manually.

go install github.com/mvanhorn/printing-press-library/library/marketing/trendhunter/cmd/trendhunter-pp-mcp@latest

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "trendhunter": {
      "command": "trendhunter-pp-mcp"
    }
  }
}

Quick Start

# Pull the latest 30 trends + sitemap and write them to the local store.
trendhunter-pp-cli sync

# Search the local corpus first, with a flag to fan-out live.
trendhunter-pp-cli search "AI clone" --json

# Week-over-week digest with new vs repeat split.
trendhunter-pp-cli digest --since 7d --category eco --json

# Pull the FAQ JSON-LD from any /trends/<slug> page.
trendhunter-pp-cli faq ai-clone --json

# One-shot agent brief: ranked trends with FAQ Q&A.
trendhunter-pp-cli brief --category ai --top 10 --format markdown

Unique Features

These capabilities aren't available in any other tool for this API.

Local state that compounds

• digest — Generate a week-over-week digest of new vs repeat trends in a category with top rising keywords.

  Agents pulling a weekly competitive scan can ask 'what's new in eco this week' without re-clicking 30 cards by hand.

  trendhunter-pp-cli digest --since 7d --category eco --json

• watch — Per-category new-only feed - fills the gap that TrendHunter's RSS is global-only.

  Agents and indie scouts get a clean delta for one vertical without re-processing the global firehose.

  trendhunter-pp-cli watch --category gadgets --since 24h --json

• cluster — Surface rising keyword clusters via FTS5 co-occurrence with a rising-vs-prior-window delta.

  Agents researching an emerging theme see which adjacent keywords are accelerating, not just the headline trends.

  trendhunter-pp-cli cluster --window 30d --min-count 3 --json

• authors — Rank TrendHunter authors and futurists by time-windowed publish rate, not lifetime count.

  Find which trend hunters are currently active in your space, not just who has the biggest historical footprint.

  trendhunter-pp-cli authors --top 20 --since 30d --json

• inbox — Show trends seen since the last invocation of inbox - a per-machine cursor table.

  Build it into a Monday-morning routine and only ever see things you haven't seen before.

  trendhunter-pp-cli inbox --json

Agent-native extraction

• faq — Extract the FAQPage JSON-LD from a trend page into structured Q&A.

  Agents get a ready-to-quote Q&A summary of each trend without prompting another LLM to summarize the article.

  trendhunter-pp-cli faq ai-clone --json

• brief — One-shot agent brief: top-N ranked trends in a category, each with FAQ Q&A and keywords, rendered as JSON or markdown.

  Plugs straight into an agent prompt as ground truth for a market memo, no glue code needed.

  trendhunter-pp-cli brief --category ai --top 10 --format markdown

• scout — Pull top trends in a category, score each by relevance to a business profile, optionally route the scoring through a local LLM.

  Agents researching a vertical get a ranked, business-scoped trend list ready to pipe into the next stage of their pipeline.

  trendhunter-pp-cli scout --category kitchen --business "We sell smart ovens for home cooks" --top 10 --llm

Graph and synthesis

• megatrend-map — Walk the related-trend graph two levels deep from a starting slug, returning depth-1 and depth-2 related slugs so you can see which free trends cluster around a given concept.

  Evaluators deciding whether a paid megatrend report is worth $295 can see which free trends ladder up to it.

  trendhunter-pp-cli megatrend-map ai-clone --json

Usage

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

Commands

category

Category index pages (tech, fashion, food, eco, ai, marketing, design, ...)

• trendhunter-pp-cli category list - Fetch a TrendHunter category index page (~30 trend cards). The CLI's 'category ' command parses this.

megatrends

Megatrend / pattern index pages.

• trendhunter-pp-cli megatrends list - Fetch the megatrend index page.

popular

Curated 'popular right now' index.

• trendhunter-pp-cli popular get - Fetch the popular-trends index page (~30 cards). Run 'popular' to get parsed JSON.

reports

Trend report index.

• trendhunter-pp-cli reports list - Fetch the trend-reports landing page (titles, descriptions, paid PDF links).

results

Site search-results endpoint (the framework already provides a hand-built search command; this exposes the raw HTML page).

• trendhunter-pp-cli results query - Run a TrendHunter search and get the result-page HTML. The CLI's 'search ' parses this; pass --raw to get HTML.

rss

Global RSS feed of the 30 latest trends across the whole site.

• trendhunter-pp-cli rss latest - Fetch the global RSS 2.0 feed (~30 newest trends). Use 'sync' to land these in the local store; this raw endpoint is for one-off inspection.

scoreboard

Top contributors and trends scoreboard.

• trendhunter-pp-cli scoreboard get - Fetch the scoreboard page with top contributor handles and recent trends. Run 'scoreboard' to get parsed JSON.

sitemap

Master sitemap with 430+ URLs (categories, futurists, contributors, hubs).

• trendhunter-pp-cli sitemap get - Fetch the sitemap.xml. The CLI's 'catalog refresh' uses this; users should use that instead.

trends

Individual trend pages with full metadata, FAQ Q&A, related trends, author, category.

• trendhunter-pp-cli trends get - Fetch the full trend page HTML for a slug. The CLI's 'trend show ' parses this; users should use that instead of calling this directly.

Output Formats

# Human-readable table (default in terminal, JSON when piped)
trendhunter-pp-cli category mock-value

# JSON for scripting and agents
trendhunter-pp-cli category mock-value --json

# Filter to specific fields
trendhunter-pp-cli category mock-value --json --select id,name,status

# Dry run — show the request without sending
trendhunter-pp-cli category mock-value --dry-run

# Agent mode — JSON + compact + no prompts in one flag
trendhunter-pp-cli category mock-value --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

trendhunter-pp-cli doctor

Verifies configuration and connectivity to the API.

Configuration

Config file: ~/.config/trendhunter-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

API-specific

• Search returns no results after install — Run trendhunter-pp-cli sync first - search is local-first and needs a corpus.
• HTTP 403 on a fetch — Update the CLI; the default Chrome UA may be too old for the site's filter. go install ...@latest and try again.
• Trend page redirects to a vertical microsite (cleanthesky.com etc) — The CLI follows redirects; the canonical /trends/ URL still resolves and is what the local store records.

Discovery Signals

This CLI was generated with browser-captured traffic analysis.

• Target observed: https://www.trendhunter.com/
• Capture coverage: 11 API entries from 30 total network entries
• Reachability: standard_http (95% confidence)
• Protocols: html (100% confidence), rss (100% confidence)
• Generation hints: Use stdlib HTTP transport (http_transport: standard)., Default UA must imitate Chrome - curl default UA is blocked., Default Accept header must be Chrome-style 'text/html,application/xhtml+xml,application/xml;q=0.9,/;q=0.8' - bare '/' is blocked., RSS feed is global only. Per-category RSS returns valid-but-empty channels; do not call them., Trend pages occasionally redirect to vertical microsites (cleanthesky.com, etc.). Follow redirects; record the canonical /trends/ URL., FAQPage JSON-LD on /trends/ is the highest-density agent-summary surface; extract with the faq command., No clearance cookie, no Surf, no browser sidecar.

---

Generated by CLI Printing Press