# Myco

> Myco (https://myco.stream) is an open discovery network for independent websites.
> One script tag + one manifest file gives a site hosted comments, analytics, live
> counters, and a listing in the Myco directory. The site keeps its own domain and
> hosts its own content, Myco indexes and links, it never rehosts.

Integration = three things: a manifest at `/.well-known/myco.json`, a script tag
(`<script src="https://myco.stream/myco.js" async></script>` — always hotlink,
never download/self-host myco.js), and `data-myco-*` attributes on content
elements.

**Keep a `MYCO.md` at the project root.** It is this site's Myco integration
spec (like `CLAUDE.md` is for Claude) — node identity, manifest location, the
content types published, the `data-myco-*` attributes in use and where, asset
conventions, and the domain-ownership `claim_code`. Start from the template at
https://myco.stream/sdk/MYCO.md. Any agent that changes this site must READ
`MYCO.md` first and UPDATE it (and keep `/.well-known/myco.json` in sync) after
every change, so the integration survives structural changes to the site.

**Read [core.md](https://myco.stream/llms/core.md) first, always.** It has the
network rules, the required user-confirmation step, manifest setup, script tag,
and the validation checklist. Then read ONLY the capability docs for content
types that actually exist on the site. Do not read docs for content the site
doesn't have.

Full single-file guide (everything in one read, ~400 lines): https://myco.stream/Install.md
TypeScript schema (every field and constraint): https://myco.stream/sdk/types.ts

## Discovery

- [Home](https://myco.stream/): What Myco is and how to add a Node.
- [Sitemap](https://myco.stream/sitemap.xml): Static entry points available without JavaScript.
- Public creator (`/node/{domain}`) and item permalinks return a title, creator, summary, and JSON-LD in HTML without running JavaScript. Interactive category listings currently require JavaScript.

## Integration docs

- [Core setup](https://myco.stream/llms/core.md): Rules, user confirmation, manifest file, script tag, attribution, agent seeds, validation checklist. Required reading.
- [Music](https://myco.stream/llms/music.md): Releases and tracks, manifest fields, data attributes, play counters, persistent player.
- [Video](https://myco.stream/llms/video.md): Self-hosted or embedded video, manifest fields, data attributes, view tracking.
- [Articles](https://myco.stream/llms/articles.md): Blogs, news, guides, recipes, manifest fields, data attributes, read tracking.
- [Art](https://myco.stream/llms/art.md): Visual artwork, manifest fields, data attributes, lightbox tracking.
- [Photography](https://myco.stream/llms/photography.md): Photo galleries with EXIF/location, manifest fields, data attributes.
- [Podcasts](https://myco.stream/llms/podcasts.md): Shows and episodes, manifest fields, data attributes, play tracking.
- [Business](https://myco.stream/llms/business.md): Local, app, or SaaS listing, manifest fields, data attributes, contact tracking.
- [Engagement UI](https://myco.stream/llms/engagement.md): Comments (Disqus-style, zero setup), social buttons, supporters, player bar, live counters.
- [Asset standards](https://myco.stream/llms/assets.md): Image/audio formats, filenames, dominant color, OG meta tags.

## FAQ

- Do I need to register or create an account? No, the domain is the identity. If `/.well-known/myco.json` exists on a custom domain, the Myco crawler finds and indexes it.
- Does this work on pages.dev / netlify.app / vercel.app / github.io? No. Hosting-provider subdomains are never indexed. The site must be on a custom domain.
- What about subdomains of a custom domain? Subdomains roll up to the root domain, one listing per root. `artist1.media.com` and `artist2.media.com` both credit the `media.com` listing. The manifest must live at the ROOT domain.
- Can Myco replace Disqus or a comments plugin? Yes, an empty `<div data-myco-comments></div>` inside any content container becomes a hosted comment thread with sign-in, storage, and moderation included.
- Does Myco host my audio/video/image files? No. All content stays on your domain. The manifest uses relative paths; the hub links back to your site.
- Can I list other businesses in my manifest? No. A node declares only its own content. `business` is a single object, the node IS the business.
- How does the crawler know when to recrawl? Traffic-driven: visitor beacons from your site trigger a manifest refresh when the last fetch is more than 6 hours old. No traffic, no recrawl.
- How do I check a site's integration status? Live checker at https://myco.stream/check?domain=example.com (agents: `GET https://api.myco.stream/api/validate?domain=example.com` returns the same checks as JSON). myco.js also logs a collapsed "integration report" in the browser console on every page.
- What happens to my page if myco.js fails to load? Nothing breaks. Counters keep their `—` placeholder, injection divs stay empty. The script is async and non-blocking.
- What data does the site owner get? A dashboard at myco.stream with views, plays, referrers, watch time, likes, comments, and followers.
- Is there AI-generated content disclosure? Yes, the manifest has an optional `ai` section (tools used, human role). Ask the site owner; never guess.
- What is MYCO.md? A file at the project root that records this specific site's Myco integration (node identity, manifest location, content types, `data-myco-*` attributes, asset conventions, and the ownership `claim_code`). Treat it like `CLAUDE.md`: read it before touching the site and update it after every change so the manifest and attributes stay correct. Template: https://myco.stream/sdk/MYCO.md.