CtrlK
BlogDocsLog inGet started
Tessl Logo

hacker-news-scraper

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.

80

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

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

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

CLI Reference

FlagDefaultDescription
--queryrequiredSearch query
--days7How many days back to search
--tagsstoryItem type: story, comment, ask_hn, show_hn
--max-results50Max results to return
--keywordsnoneAdditional filter keywords (comma-separated, OR logic)
--outputjsonOutput 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.

Repository
gooseworks-ai/goose-skills
Path

skills/monitoring/capabilities/hacker-news-scraper/SKILL.md

Commit

8866b2a

Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill