Agent skill
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.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/hacker-news-scraper-gooseworks-ai-goose-skills
SKILL.md
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_dateendpoint) - 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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?