Hackernews

Learn how to use Hackernews with Composio

Overview

SLUG: HACKERNEWS

Description

Hacker News is a tech-focused news aggregator by Y Combinator, featuring user-submitted stories and discussions on startups, programming, and emerging trends

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Hackernews toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["HACKERNEWS"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Get Hackernews Frontpage

Description

Get the frontpage posts of hacker news.

Action Parameters

min_points
integerDefaults to 40

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Hackernews Item

Description

Get a specific item from hacker news using its id. limits response size to prevent context overflow.

Action Parameters

item_id
stringRequired
max_children
integerDefaults to 10
max_depth
integerDefaults to 2
truncate_text
booleanDefaults to True

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Latest Hackernews Posts

Description

Get the latest posts from hacker news based on optional filters. results can be limited using the size parameter.

Action Parameters

page
integer
size
integerDefaults to 5
tags
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Hackernews Today Posts

Description

Get today's posts from hacker news.

Action Parameters

min_points
integerDefaults to 200

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Hackernews User

Description

Get a specific user from hacker news using their username.

Action Parameters

username
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Search Hackernews Posts

Description

Get relevant posts from hacker news based on a full-text query and optional filters. results can be limited using the size parameter.

Action Parameters

page
integer
query
stringRequired
size
integerDefaults to 5
tags
array

Action Response

data
objectRequired
error
string
successful
booleanRequired