Agent skill

hacker-news-scraper

Search Hacker News stories and comments using the free Algolia API.

dormantReaches the webActs undeclared254 words

From edupegoretti/fluidz-skills · 116 skills · 0 · pushed 2026-03-11

What it does when it runs

Search Hacker News stories and comments using the free Algolia API. No Apify token needed. Use when you need to find HN discussions, track mentions, discover Show HN launches, or monitor tech community sentiment.

Read from the skill and the 2 files bundled beside it. A skill’s own description is written to be selected by an agent, so it describes the job and not the dependencies.

Keys and connectors you must supply: None found.
Hosts it reaches: hn.algolia.com
news.ycombinator.com
Tool permissions it declares: No allowed-tools in the frontmatter. It does act, so it runs under whatever permissions your session already grants.
Actions present in the files: shellnetwork

Ask about hacker-news-scraper

Opens your assistant with this page's verified links already in the prompt.

Is this safe to install?Claude ChatGPT

Adapt it to my stackClaude ChatGPT

What else do I need for it to workClaude ChatGPT

Rather ask a human? Talk to Cheetah

Install it

View source on GitHub ↗

git clone --depth 1 --filter=blob:none --sparse https://github.com/edupegoretti/fluidz-skills.git /tmp/fluidz-skills
git -C /tmp/fluidz-skills sparse-checkout set "skills/capabilities/hacker-news-scraper"
mkdir -p ~/.claude/skills/hacker-news-scraper
cp -R "/tmp/fluidz-skills/skills/capabilities/hacker-news-scraper/." ~/.claude/skills/hacker-news-scraper/

Picked up without a restart. A project skill of the same name is shadowed by your personal one. For one repository only, swap ~/.claude/skills for .claude/skills. Claude Code docs ↗

The folder is the same in every client that implements the format — 46 of them — so if yours is not above, only the destination changes.

The skill

Source on GitHub ↗

Reproduced in full from edupegoretti/fluidz-skills/blob/a2cf697e2e8ec2ea517d85496e2d5c7f5dc44cd3/skills/capabilities/hacker-news-scraper/SKILL.md, which is licensed MIT (repository). 254 words, 9 headings.

Hacker News Scraper

Search Hacker News using the free Algolia HN Search API. No Apify token or API key needed.

Quick Start

Only dependency: pip install requests.

# Stories about AI content marketing in last week
python3 skills/hacker-news-scraper/scripts/search_hn.py \
  --query "AI content marketing" --days 7

# Show HN posts in last month (summary view)
python3 skills/hacker-news-scraper/scripts/search_hn.py \
  --query "" --tags show_hn --days 30 --output summary

# Comments mentioning a specific tool
python3 skills/hacker-news-scraper/scripts/search_hn.py \
  --query "LangChain" --tags comment --days 14 --max-results 20

How the Script Works

Queries the Algolia HN Search API (search_by_date endpoint)
Uses numericFilters=created_at_i>{unix_timestamp} for server-side date filtering
Paginates until max-results reached
Normalizes results to a consistent schema
Applies optional keyword filtering (client-side)
Sorts by points (descending) and outputs JSON or summary

CLI Reference

Flag	Default	Description
`--query`	required	Search query
`--days`	7	How many days back to search
`--tags`	story	Item type: `story`, `comment`, `ask_hn`, `show_hn`
`--max-results`	50	Max results to return
`--keywords`	none	Additional filter keywords (comma-separated, OR logic)
`--output`	json	Output format: `json` or `summary`

Output Format

{
  "id": "12345678",
  "title": "Show HN: My new tool",
  "url": "https://example.com",
  "author": "username",
  "points": 42,
  "num_comments": 15,
  "created_at": "2026-02-18T12:00:00.000Z",
  "hn_url": "https://news.ycombinator.com/item?id=12345678",
  "text": ""
}

Cost

Free. No API key, no rate limits (within reason), no Apify credits.

Files bundled with it

These load only when the skill asks for them, so they cost nothing until it runs.

Need help setting it up?

This page tells you what hacker-news-scraper does and what it needs. Cheetah builds the agent setup it runs inside: data, CRM, sequencing and the guardrails.

Book a call →

The directory stays free. There is nothing gated behind this.