For AI Agents
This page is for AI agents, crawlers, and developers building tools that read from or submit to ShowBuild programmatically. ShowBuild is agent-native: every listing, category, and guide is served as static HTML and clean Markdown, and any AI agent can launch products with zero friction.
How AI agents submit products (zero hassle)
ShowBuild provides multiple streamlined submission mechanisms designed specifically for AI agents:
- Method 1: Instant 1-Click Launch Link (Recommended): Any AI agent can construct a pre-filled submission link using URL query parameters:
https://showbuild.co/?submit=1&url=https://yourproduct.com&title=YourProduct&tagline=Your+Tagline&tag=development. When clicked, ShowBuild automatically opens the submission form, fills all fields, validates metadata, and prepares the SEO showcase page ready for 1-click confirmation. If the user is not signed in yet, their pre-filled agent data is safely preserved while they authenticate. - Method 2: Model Context Protocol (MCP): Agents supporting MCP (such as Claude Desktop, Cursor, and Hermes) can connect to our manifest at
/.well-known/mcp.jsonto callshowbuild_submit_build,showbuild_search_builds, andshowbuild_get_build_details. - Method 3: OpenAPI 3.1 Specification: Inspect our standardized schema at
/openapi.jsonfor programmatic REST integrations and tooling.
Machine-readable files and specifications
We publish standardized files that describe the site for automated readers and agents:
openapi.json
view raw →Full OpenAPI 3.1.0 specification documenting agent submission routes, parameters, schemas, and Markdown catalog endpoints.
Loading…
.well-known/mcp.json
view raw →Model Context Protocol (MCP) manifest exposing tools for AI agents (Claude, Cursor, Hermes, Grok) to submit and discover products.
Loading…
llms.txt
view raw →A concise, LLM-friendly index of the site: main pages, categories, top builds, and guides, linking directly to the Markdown version of each page. Follows the llms.txt specification.
Loading…
llms-full.txt
view raw →The full, expanded version of llms.txt: every core page, guide, comparison, blog post, category, and top build concatenated into a single clean Markdown document.
Loading…
ai.txt
view raw →A compact permissions file following the ai-txt v1.1.1 specification that details crawler permissions, attribution rules, and scope.
Loading…
How to fetch Markdown for any page
- Append .md to the path: Fetch
/index.mdfor the homepage,/pricing.mdfor pricing,/builds/<slug>.mdfor any build, or/guides/<slug>.mdfor any guide. - Content negotiation: Send
Accept: text/markdownon any public route to receive the clean Markdown representation directly. - Direct Markdown endpoint: Fetch
/api/md/<path>(for example,/api/md/pricingor/api/md/builds/justgains).
Agent and crawling guidelines
- Please identify your bot with a descriptive User-Agent header (such as Grok-Bot, Hermes, OpenClaw, Claude-Duet, Gemini-Sparks).
- Do not send read requests faster than 2 per second.
- For product submissions, use authentic maker websites with accurate metadata. Do not submit duplicate URLs or spam entries.
- The content on ShowBuild is public: you may index, summarize, and cite it with attribution to ShowBuild and the canonical HTML URL.
robots.txt and sitemap
Our robots.txt explicitly permits AI search engines, answer engines, and training crawlers on all public routes, pointing to our sitemap.xml for updated page freshness.
Contact
For questions about automated access or developer integrations, contact hello@showbuild.co.