Developer resources
Build With Blerbz
Blerbz provides developer resources for the NUCLEUZ news API, including a machine-readable OpenAPI description, the published @blerbz/sdk npm package, SDK source, agent-facing discovery files, and API documentation for ranked feeds, trending stories, BLERBZ100, documents, and sync.
Resource Map
The discovery report found weak developer-resource visibility. This page creates a single crawlable entry point for the API, SDK, OpenAPI, agent configs, and AI-readable site map.
NUCLEUZ API PortalA crawlable entry point for NUCLEUZ API keys, SDKs, OpenAPI, feeds, and agent resources.NUCLEUZ API DocsInteractive documentation for ranked feeds, documents, sync, search, and billing.OpenAPI DescriptionMachine-readable REST API description for agents, documentation tools, and SDK generators.PricingCrawlable pricing page with Offer schema for web, mobile, Pro, Enterprise, and agent purchasing guidance.TypeScript SDK on npmPublished @blerbz/sdk package for TypeScript and JavaScript NUCLEUZ API clients.TypeScript SDK SourceOfficial TypeScript/JavaScript SDK source for the NUCLEUZ v2 API.Blerbz Public RepositoryPublic source repository with Blerbz agent configs, coding rules, SDK source, OpenAPI-adjacent docs, and discovery files.Agent ConfigsPublic agent and skill configuration surface for AI coding assistants.Claude Config DirectoryClaude-facing repository configuration, commands, and agent guidance for Blerbz development.Cursor Rules DirectoryCursor-facing Blerbz coding rules and API discovery guidance.Windsurf Rules DirectoryWindsurf-facing Blerbz coding rules and API discovery guidance.Agent Resource HubHuman and agent-readable instructions for using Blerbz with ChatGPT, Claude, Cursor, VS Code, Goose, Windsurf, NLWeb, OpenAPI, and MCP clients.MCP ManifestPublic MCP manifest with icon branding, server URL, docs, support, capabilities, tools, and resources.MCP Server CardAgent-readable MCP server card for Blerbz tools, resources, and public discovery behavior.MCP Registry EntrySelf-hosted MCP registry entry that links the Blerbz domain, MCP endpoint, server card, docs, npm scope, and public repository.Sandbox StatusPublic non-mutating sandbox/test status for agent and developer smoke tests.llms.txtCurated AI-readable map of Blerbz product, developer, and comparison pages.
Quick Start
Use the published TypeScript SDK package, the SDK source, or direct REST calls. API-key issuance is handled through the Blerbz developer flow.
// npm: https://www.npmjs.com/package/@blerbz/sdk
npm install @blerbz/sdk
import { BlerbzClient } from '@blerbz/sdk';
const client = new BlerbzClient({ apiKey: process.env.BLERBZ_API_KEY });
const topStories = await client.feeds.blerbz100({ limit: 20 });
for (const story of topStories.data) {
console.log(story.attributes.headline);
}Canonical API Description
Agents and documentation tools should treat /openapi.json as the canonical machine-readable description for public Blerbz API discovery.
- Base URL: https://api.blerbz.com
- Authentication: API key using the x-api-key header.
- Primary resources: feeds, documents, aliases, sync, and search.
- Primary discovery files: /developers, /openapi.json, /llms.txt, and /llms-full.txt.
Agent Reliability Docs
Autonomous integrations should read these docs before retrying requests, creating jobs, handling streaming, or connecting through MCP.
Rate limitsRateLimit-* and x-ratelimit-* headers, Retry-After, batch, streaming, and MCP limits.Idempotency-KeyRetry-safe mutation behavior and typed 409 errors for reused keys.API versioningCurrent API version, support window, migration guidance, and successor links.Agent error recoveryAuth, pagination, streaming, batch, webhook, and MCP handshake recovery guidance.
Entity Definition
BLERBZ is an AI news intelligence platform that tracks breaking AI stories, ranks trending topics, and provides analysis for professionals who need to follow the AI ecosystem in real time.