# xmr.club — embed widgets

> Drop xmr.club into your own site. Plain-text twin of https://xmr.club/widget/. All assets CC-BY-4.0 — attribute "xmr.club" when reusing.

zh-TW: https://xmr.club/zh/llm/widgets.txt

## 1. Listed-on-xmr.club partner badge

Generic badge for providers whose listings live on xmr.club. Drop it in your footer; readers click through to your provider page.

- Asset: https://xmr.club/badge/listed.svg (240×80)
- Embed:

```html
<a href="https://xmr.club/<category>/<id>" target="_blank" rel="noopener">
  <img src="https://xmr.club/badge/listed.svg" alt="Listed on xmr.club" width="240" />
</a>
```

## 2. Per-provider grade badge

Live-rendered SVG with the provider's current grade colour + ★ PICK marker when applicable. Re-renders from D1 on each fetch.

- Pattern: https://xmr.club/badge/<id>.svg
- Example: https://xmr.club/badge/sideshift.svg
- Embed:

```html
<a href="https://xmr.club/<cat>/<id>" target="_blank" rel="noopener">
  <img src="https://xmr.club/badge/<id>.svg" alt="xmr.club rating" />
</a>
```

## 3. Embedded category iframe

Live mini-directory of a single category, no chrome. X-Frame-Options unset so it embeds anywhere.

```html
<iframe src="https://xmr.club/embed/<category>" width="100%" height="600"
        style="border:1px solid #1f1f1f; border-radius:6px;"></iframe>
```

## 4. JSON + Atom feeds

Raw data — pull the dataset, build whatever UI you want.

- https://xmr.club/data.json — full structured dataset
- https://xmr.club/feed.json — JSON Feed v1.1 of recently-verified entries
- https://xmr.club/feed.xml — Atom feed (same content)
- https://xmr.club/api/content/<category> — per-category JSON
- https://xmr.club/feed/tag/<slug>.json — per-tag JSON feed

## 5. AI-ready markdown twins

No-chrome plaintext for AI engines that prefer canonical summaries over HTML scraping.

- https://xmr.club/llms.txt — concise site index
- https://xmr.club/llms-full.txt — A-grade picks per category + full guide bodies
- https://xmr.club/llm/<page>.txt — per-page twin (e.g. /llm/about.txt, /llm/methodology.txt, /llm/colophon.txt)
- https://xmr.club/llm/<category>.txt — per-category markdown
- https://xmr.club/llm/<cat>/<id>.txt — per-provider summary
- https://xmr.club/llm/tag/<slug>.txt — cross-category by tag
- https://xmr.club/llm/guides/<slug>.txt — per-guide twin

## Programmatic catalogue

- JSON form of this file: https://xmr.club/api/v1/widgets
- Surface-discovery API: https://xmr.club/api/v1/llm-surfaces

## License + attribution

CC-BY-4.0. Attribute "xmr.club" when reusing badges, iframes, or data. Brand-guideline or partner-attribution questions: DM https://t.me/xmrclub_bot.