src ▸ site opened 0

Turn Hacker News into a REST + MCP endpoint

Writ turns the Hacker News actions you already do in a browser into a callable REST endpoint your software (and your AI agents) can call.

Writ runs on your own accounts, with your own credentials and data, on sites you are authorized to use.
call-hackernews.shPOST /v1/hackernews/run
bash
curl -X POST https://api.usewrit.app/v1/hackernews/run \
  -H "Authorization: Bearer wt_8f2c...a91" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "query": "your search term" } }'
REST endpoint MCP tool structured JSON
new ▸ endpoint minted 01
02
create

No Hacker News API yet? Build one in minutes

Record the Hacker News task once (open the front page, then read stories and points) and call it as a REST endpoint and an MCP tool. No backend project, no waiting on Hacker News to ship an API.

  1. 1
    Record the Hacker News task once

    Open the recorder and open the front page on Hacker News in a real browser. Writ captures each step, including login and 2FA, into a reusable workflow.

  2. 2
    Publish it as an endpoint

    One click turns the workflow into a callable REST endpoint at /v1/hackernews/run and a matching MCP tool. Inputs become a typed schema.

  3. 3
    Call it from anything

    Call Hacker News from your code, a no-code tool, or an AI agent. Run it on your own machine for free, or on metered cloud.

Read the REST API docs, see what's possible on workflows, or search for another site. Free to start. See pricing.

gap ▸ no public api 02
03
why

Hacker News doesn't give you the endpoint you need

Hacker News has an API, but Hacker News has a read-only Firebase API for items; the front-page ranking and live points are read in the browser for monitoring.

Writ closes that gap. Record the Hacker News task once (or describe it to an AI session) and publish it as a REST endpoint at /v1/hackernews/run and a matching MCP tool. Writ runs on your own accounts, with your own credentials and data, on sites you are authorized to use.

ops ▸ actions mapped 03
04
operations

What you can call on Hacker News

Each operation below is a real Hacker News action recorded into a workflow and exposed as a typed endpoint.

{ }open the front page
{ }read stories and points
{ }search a query
{ }export results

Returns structured fields such as story title, points, comment count, author: typed JSON, not raw page text.

run ▸ endpoint called 04
05
call it

A real Hacker News endpoint, authorized with a wt_ key

POST your inputs, get structured output. Authenticate every call with a scoped wt_ key.

cURL
bash
curl -X POST https://api.usewrit.app/v1/hackernews/run \
  -H "Authorization: Bearer wt_8f2c...a91" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "query": "your search term" } }'
Python
python
import requests

r = requests.post(
    "https://api.usewrit.app/v1/hackernews/run",
    headers={"Authorization": "Bearer wt_8f2c...a91"},
    json={"input": {"query": "your search term"}},
)
print(r.json()["output"])
response.json
json
{
  "run_id": "run_hack_7b21",
  "status": "succeeded",
  "output": {
    "story_title": "...",
    "points": "...",
    "comment_count": "..."
  }
}
{ }

Also an MCP tool. The same workflow is exposed as an MCP tool your AI agent can call. See Hacker News MCP tools, or browse all MCP clients.

auth ▸ logged-in web 05
06
the hard web

Login, 2FA, and dynamic pages on Hacker News

The reason Hacker News has no usable API is the same reason it's hard to automate. Writ handles it.

Hacker News pages are public; Writ renders them in real Chromium to capture front-page ranking and point counts as they change.

PersonasTOTP & mailbox OTP AI navigationReal Chromium rendering
build ▸ three routes 06
07
build

Three ways to build your Hacker News endpoint

Pick whichever fits the task. All three produce the same callable workflow.

Record itOpen the recorder, open the front page on Hacker News once in a real browser, and Writ captures every step into a workflow.
Describe itTell an AI session your goal on Hacker News in plain language, and it drives the page to build the workflow for you.
Discover itLet API discovery watch Hacker News's own network calls as you browse, then turn the underlying requests into a fast workflow.

Built on the same engine as the recorder and workflows.

watch ▸ changes tracked 07
08
watch

Trigger your Hacker News endpoint on a change

Monitor Hacker News for new story matching a query, points threshold, front-page entry and fire this endpoint the instant something changes.

Monitors check as fast as every 10s (10s on Enterprise). A detected change becomes an automation trigger that runs your workflow in seconds. Monitor Hacker News ▸

venue ▸ local or cloud 08
09
run it

Free on your own machine, or on cloud

Local / BYO agent

No compute charge. The agent runs on your hardware, so it can reach Hacker News even from an intranet or VPN-only network, and your AI keys never leave your machine.

Writ cloud

Metered by running time at $0.12 per browser-hour, drawn from your plan’s included usage. No infrastructure to manage.

faq ▸ questions answered 10
11
faq

Hacker News API questions

Does Hacker News have an API?
Hacker News has an API, but Hacker News has a read-only Firebase API for items; the front-page ranking and live points are read in the browser for monitoring. Writ gives you a callable /v1/hackernews/run endpoint that runs the real Hacker News flow in a browser and returns structured JSON.
Is there a ready-made Hacker News API I can use?
Record the Hacker News task once in the recorder (open the front page, then read stories and points) or describe it to an AI session. Writ turns it into a callable REST endpoint and MCP tool. It usually takes minutes, not a backend project.
Is it allowed to automate Hacker News this way?
Collect Hacker News data you have the right to access and respect its guidelines and rate limits. Writ runs on your own accounts, with your own credentials and data, on sites you are authorized to use.
Does this work with Hacker News login and 2FA?
Hacker News pages are public; Writ renders them in real Chromium to capture front-page ranking and point counts as they change. Writ handles TOTP and mailbox-OTP two-factor through Personas, so the endpoint runs inside your own authenticated session.
Can I run it on my own machine?
Yes. Run it on a local or BYO agent for no compute charge — useful when Hacker News is only reachable from your own network or VPN, and free on every plan. Or run it on metered cloud at $0.12 per browser-hour, drawn from your plan’s included usage.
rec ▸ ready

Build a Hacker News API

Record it once, then call it from your software and your AI agents. Get started free.