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).

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