---
name: clone-fyi
description: Curated links, news, and podcasts from clone.fyi
version: 1.0.0
base_url: https://clone.fyi
endpoints:
  feed: /api/content/agent
  search: /api/discover/agent
  rss: /rss.xml
content_types:
  - articles
  - podcasts
shows:
  - Tasteland
  - Boys Club
  - Creative Complaint
  - The Desire Question
---

# clone.fyi — Agent Guide

## What is clone.fyi?
A curated feed of technology and culture links, news, and podcasts. Updated hourly at the speed of breaking news.

## Quick Start (2 calls)
1. `GET /api/content/agent` — all recent content as structured JSON
2. `GET /api/discover/agent?q=topic` — search by keyword

## Curated Paths
- **Today's links:** `GET /api/content/agent?type=articles&limit=10`
- **Latest podcast episodes:** `GET /api/content/agent?type=podcasts`
- **Episodes by show:** `GET /api/content/agent?show=tasteland`
- **Search everything:** `GET /api/discover/agent?q=your+query`
- **Content after a date:** `GET /api/discover/agent?after=2026-03-01`
- **List all shows:** `GET /api/discover/agent?shows`

## Response Format
All endpoints return JSON with this structure:
```json
{
  "site": "clone.fyi",
  "description": "Curated links, news, and podcasts",
  "updated": "ISO timestamp",
  "headlines": ["Breaking headline..."],
  "articles": [{"headline", "description", "author", "url", "published", "imageUrl"}],
  "podcasts": [{"title", "show", "description", "audioUrl", "duration", "published", "thumbnail"}]
}
```

## Common Mistakes
- Don't parse `/rss.xml` when `/api/content/agent` gives you structured JSON
- Don't scrape the homepage HTML — use the API endpoints
- Don't forget the `show` parameter is case-insensitive
- Use `after` parameter with ISO dates for time-filtered queries

## Other Discovery Endpoints
- `/llms.txt` — LLM discovery file
- `/.well-known/ai.json` — machine-readable site profile
- `/.well-known/agent-card.json` — Google A2A agent card
- `/.well-known/skills/index.json` — skills catalog