> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# HackerNews

> Connect HackerNews to xpander and give agents its 10 actions: how to sign in and connect it, and which actions to hold for approval.

HTTP API connector

An HTTP API described by an OpenAPI spec, not an MCP server. Calls go to `https://yc-hacker-news-official.p.rapidapi.com` and carry a credential xpander supplies, so there is nothing to paste.

## What the skill can do

API connector: 10 actions, as they appear in the skill panel. 0 of them create, change or delete something in HackerNews; mark those under **These actions need approval** when you add the skill to an agent.

* **User profile service** (7): Get Top Story IDs, Get New Story IDs, Get Ask HN Story IDs, Get User Profile by ID, Get Best Story IDs, Get Job Story IDs, Get Show HN Story IDs
* **Item details service** (2): Get Item Details by ID, Get Current Largest Item ID
* **Update tracking** (1): Get Recent Item and User Changes

## Connect HackerNews

In Xpander Chat, open the agent's settings, click **Add skill**, and search for **HackerNews**. The connect dialog asks for a connection name and whether the connection is for the **Organization** (one shared account) or **Personal** (your own account, so the agent acts with your permissions where systems allow). On an agent other people use, a personal connection runs their requests as you unless the binding requires each person's own sign-in; see [whose credential a shared agent uses](https://docs.xpander.ai/use/agents/permissions.md#whose-credential-a-shared-agent-uses).

HackerNews connects with **Sign in with HackerNews**: you authorize in the browser and xpander stores the OAuth token; the agent never sees it, and the token is attached at the moment a skill is called.

Calls go to `https://yc-hacker-news-official.p.rapidapi.com`.

## Give an agent the HackerNews skill

Once HackerNews is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **HackerNews**. Enable only the action groups the agent needs, and mark the actions that should wait for a named person's sign-off under **These actions need approval**. Which skills exist for your organization, and who may add them, is decided by your admins; see [Skills](https://docs.xpander.ai/use/skills.md).

## Related Resources

* [Skills](https://docs.xpander.ai/use/skills.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.