# Catalog guide

> How to browse ListBulb — an AI tools directory for founders — and consume its catalog through HTML, REST, MCP, JSON-LD, llms.txt, ai.txt, RSS, and sitemap.

Canonical: https://www.listbulb.com/docs/getting-started
Last updated: 2026-11-13

Browse ListBulb's public catalog and crawlable discovery resources (Catalog & feeds).

## About the catalog

**AI tools directory for founders launching products.** ListBulb is a product discovery platform and AI tools directory. Submit a product URL; after review, your product goes live at /tools/[slug].

## Addressable routes

Filtered query URLs (`?q=`, `?tag=`) are noindex. Use [/tools](https://www.listbulb.com/tools) and [sitemap.xml](https://www.listbulb.com/sitemap.xml) for full-catalog discovery. 6 categories are live.

- [/](https://www.listbulb.com): Homepage — featured picks and this week's launches
- [/tools](https://www.listbulb.com/tools): Full product directory (supports ?q and ?tag filters; filtered URLs are noindex)
- `/tools/{slug}`: Single product detail (category, tags, FAQ, official link)
- `/tools/{slug}/alternatives`: Related tools in the same category
- `/category/{slug}`: Products in one primary category
- `/tag/{slug}`: Tag hubs (tags with 2+ live tools)
- [/recently-launched](https://www.listbulb.com/recently-launched): Newest approved listings
- [/best-ai-tools](https://www.listbulb.com/best-ai-tools): Top live tools with Featured and paid plans first, with category filters
- [/saas-directory](https://www.listbulb.com/saas-directory): SaaS directory shortlist of live AI and SaaS products (Discover paid-first order)
- [/free-ai-tools](https://www.listbulb.com/free-ai-tools): Live tools tagged with free-tier or freemium plans
- [/free-tools](https://www.listbulb.com/free-tools): Free maker utilities
- [/submit](https://www.listbulb.com/submit): Submit a product for review
- [/launch-directories](https://www.listbulb.com/launch-directories): DR-ranked startup directories
- [/pricing](https://www.listbulb.com/pricing): Listing plans
- [/faq](https://www.listbulb.com/faq): Site FAQ
- [/about](https://www.listbulb.com/about): About ListBulb and how review works
- [/changelog](https://www.listbulb.com/changelog): Product releases
- [/blog](https://www.listbulb.com/blog): Launch playbooks and founder guides
- [/docs/getting-started](https://www.listbulb.com/docs/getting-started): Catalog and feeds guide

## Machine-readable catalog

No API keys are needed for public feeds.

| Resource | Format | Purpose |
| --- | --- | --- |
| /llms.txt | text/plain | Short site summary, taxonomy, featured picks, and catalog pointers |
| /llms-full.txt | text/plain | Full catalog dump — categories, FAQs, and every live tool entry |
| /ai.txt | text/plain | AI usage policy — permissions, restrictions, attribution, and training rules |
| /robots.txt | text/plain | Crawler rules — AI bots explicitly allowed on public pages |
| /rss.xml | application/rss+xml | RSS feed of the 100 newest approved tools |
| /sitemap.xml | application/xml | All indexable HTML URLs (tools, categories, tags, hubs) |

## Structured data (JSON-LD)

- WebSite and Organization JSON-LD on every public page (publisher, search action).
- SoftwareApplication JSON-LD on the homepage and /pricing — listing plan offers in USD.
- FAQPage JSON-LD on /faq (full site FAQ) and on each live /tools/[slug] page.
- SoftwareApplication JSON-LD on each live tool page (name, category, official URL).
- BreadcrumbList and ItemList/CollectionPage JSON-LD on browse hubs and category/tag pages.
- Alternatives pages: WebPage + SoftwareApplication subject + ItemList of SoftwareApplication comparisons.

## Discovery model

- Each tool has exactly one primary category (navigation shelf at /category/[slug]).
- Optional tags (0–5 per tool) are cross-cutting filters on the homepage directory.
- Listings go live only after someone on our side reads the submission.
- Featured picks are highlights we chose by hand; verified means the owner proved domain control, not paid placement.
- Workflow stages (ai/dev/design/ship) are not used; discovery is category + tags only.

## Submitting a tool

Founders submit at [/submit](https://www.listbulb.com/submit) in the browser. Only `/api/v1/*` is a supported integration API. Other `/api/*` routes power the website and are not public integration endpoints. Model Context Protocol support is available at `/mcp` — see the [MCP guide](https://www.listbulb.com/docs/mcp).