Connect AI Agents to
Atlassian Confluence
Automate workflows and connect AI agents to Atlassian Confluence. Metorial is built for developers. Handling OAuth, compliance, observability, and more.
Connect AI Agents to
Back to Atlassian Confluence overview
Understanding Story and Comment Data Structure
What is Story and Comment Data?
When you interact with the Hacker News MCP server, you'll primarily work with two types of content: stories and comments. Understanding how this data is structured will help you make more effective queries and better interpret the results you receive.
Story Data Structure
Stories are the primary content items on Hacker News—these include links to articles, Show HN posts, Ask HN questions, and job postings. Each story contains several key pieces of information:
Basic Identification: Every story has a unique numeric ID that distinguishes it from all other items on Hacker News. This ID is permanent and can be used to retrieve the specific story at any time.
Content Details: Stories include a title, and optionally a URL pointing to external content or text content for self-posts. You'll also see the username of the person who submitted the story and the exact timestamp of when it was posted.
Engagement Metrics: The score (or points) indicates how many upvotes the story has received, reflecting community interest. Stories also track the number of comments they've generated, giving you a sense of how much discussion they've sparked.
Story Types: The data structure distinguishes between different submission types—standard stories linking to external content, Ask HN posts where users pose questions to the community, Show HN posts where creators share their projects, and job listings.
Comment Data Structure
Comments represent the discussion layer on Hacker News and follow a hierarchical, threaded structure. Each comment contains:
Identity and Relationships: Like stories, each comment has a unique ID. Comments also reference their parent—either the story they're commenting on or another comment they're replying to. This parent-child relationship creates the conversation threads you see on the site.
Content and Metadata: The actual comment text, the username of the commenter, and the posting timestamp are all included. Comments may also have a score if they've received upvotes from other users.
Thread Structure: Comments can have multiple children (replies), creating branching discussion trees. When you retrieve a comment, you can access its entire subtree to see all nested replies and follow conversation threads through multiple levels.
Working With Nested Data
The hierarchical nature of comments means you'll often encounter nested structures. When you request a story's comments, you receive the top-level comments, each of which may contain arrays of child comments, which themselves may have children. This tree structure mirrors how conversations naturally branch and evolve.
Understanding this nesting is crucial for navigating discussions effectively. You can choose to retrieve just top-level comments for a quick overview or traverse the entire tree to explore deep conversations and side discussions.
Practical Tips
When querying stories, specify whether you want top, new, or best stories to get different perspectives on community activity. For comments, decide whether you need the full discussion tree or just high-level responses. The unique IDs are your anchor—save them when you find interesting content you might want to reference later.
Atlassian Confluence on Metorial
The Atlassian Confluence integration lets you search, read, and manage your wiki pages and spaces directly from your workflow, enabling seamless access to your team's documentation and knowledge base.
Connect anything. Anywhere.
About Metorial
Metorial provides developers with instant access to 600+ MCP servers for building AI agents that can interact with real-world tools and services. Built on MCP, Metorial simplifies agent tool integration by offering pre-configured connections to popular platforms like Google Drive, Slack, GitHub, Notion, and hundreds of other APIs. Our platform supports all major AI agent frameworks—including LangChain, AutoGen, CrewAI, and LangGraph—enabling developers to add tool calling capabilities to their agents in just a few lines of code. By eliminating the need for custom integration code, Metorial helps AI developers move from prototype to production faster while maintaining security and reliability. Whether you're building autonomous research agents, customer service bots, or workflow automation tools, Metorial's MCP server library provides the integrations you need to connect your agents to the real world.