Trail Hub / @omneity / hackernews

@omneity/hackernews

@omneity

63 downloads

Scrape HackerNews frontpage, posts and comments.

hackernews frontpage posts comments

news.ycombinator.com

What is Herd?

Herd is a powerful browser automation platform that lets you connect any AI like ChatGPT, Claude, or even Cursor to your favorite websites. This Trail is a pre-built automation for news.ycombinator.com. An MCP (Model Context Protocol) server exposes standard tools to your Agent to read from and interact with news.ycombinator.com via your browser securely.

With Herd and this trail, your agent can run:

frontpage: Returns HackerNews frontpage items with positions
user-posts: Returns posts from a HackerNews user
post-comments: Returns comments from a HackerNews post

See all actions

Learn more about Herd

Trail Details

Selected Version

v1.0.5 (5 versions available)

Published By

Omneity Labs (@omneity)

Last Updated

4/10/2025

Downloads

Quick Actions - MCP compatible

Install Herd browser extension to connect your AI tools.

Chrome

Edge

Brave

Setup Guide ▶

Supported Websites

news.ycombinator.com

Herd is not affiliated with news.ycombinator.com and is not endorsing its content. Herd makes websites accessible over MCP and API, but never hosts any content. Make sure to accept the respective terms of service before using this trail.

All trademarks reserved to their respective owners.

Installation and Usage

Quick Run

herd trail server @omneity/hackernews

SDK Implementation

Usage Example

import { HerdClient } from '@monitoro/herd';

// Initialize Herd client (use your own API key)
const herd = new HerdClient({ token: 'YOUR_HERD_API_KEY' });

// Run the 'frontpage' action
const result = await herd.runTrail('@omneity/hackernews@1.0.5', {
	actionName: 'frontpage',
	params: {
		// maxPages: "Number (Optional)"

	}
});

console.log('Trail result:', result);

Available Actions

All the following actions for @omneity/hackernews are accessible via the built-in MCP server, CLI, REST API as well as programmatically via the SDK.

frontpage

Returns HackerNews frontpage items with positions

Parameters

Name	Type	Description	Required
`maxPages`	`Number`	Maximum number of pages to scrape	No

user-posts

Returns posts from a HackerNews user

Parameters

Name	Type	Description	Required
`maxPages`	`Number`	Maximum number of pages to scrape	No
`username`	`String`	HackerNews username to fetch posts from	Yes

post-comments

Returns comments from a HackerNews post

Parameters

Name	Type	Description	Required
`format`	`String`	Format of the comments, either a list or a tree	No
`postId`	`String`	HackerNews post ID to fetch comments from	Yes
`maxPages`	`Number`	Maximum number of pages to scrape	No

user-comments

Returns comments from a HackerNews user

Parameters

Name	Type	Description	Required
`maxPages`	`Number`	Maximum number of pages to scrape	No
`username`	`String`	HackerNews username to fetch comments from	Yes