# TourismIntel — Agent Skill Manifest

> Reference: [auth.md protocol](https://github.com/workos/auth.md) (WorkOS, 2026).
> This is a public, read-only manifest describing how AI agents can discover,
> consume and (in the future) register with TourismIntel on behalf of a user.

## About TourismIntel

TourismIntel is an AI-curated travel industry news aggregator for DMOs,
hoteliers and travel-tech professionals. We publish daily briefings on AI in
travel, hotel technology and tourism innovation — curated and summarised by
Mirko Lalli, EU-recognised expert on AI and tourism.

- **Home**: https://tourismintel.ai
- **Curator**: Mirko Lalli — https://mirkolalli.me
- **Contact**: hello@tourismintel.ai
- **Languages**: English (primary), Italian (secondary)
- **Update cadence**: 12-hour news refresh; weekly editorial brief & podcast.

---

## Read-only access (no registration required)

All public content is freely accessible to agents via standard HTTP. **No API
key, no registration, no authentication is required** for the endpoints below.
They return structured, machine-readable content optimised for LLM consumption.

### Discovery

| Resource | URL | Format |
|---|---|---|
| Sitemap | `https://tourismintel.ai/api/sitemap.xml` | XML |
| Robots policy | `https://tourismintel.ai/robots.txt` | text |
| Subscribe hub (humans) | `https://tourismintel.ai/subscribe` | HTML |

### Content feeds (RSS 2.0)

| Feed | URL | Cadence |
|---|---|---|
| All travel intelligence (latest 20) | `https://tourismintel.ai/api/rss` | 12h |
| AI in travel | `https://tourismintel.ai/api/rss/ai-travel` | 12h |
| Hotel & hospitality technology | `https://tourismintel.ai/api/rss/hotel-tech` | 12h |
| Weekly Travel Intelligence Briefs | `https://tourismintel.ai/api/rss/briefs` | weekly |
| Newsletter archive | `https://tourismintel.ai/api/rss/newsletters` | on publish |
| TourismIntel Weekly Podcast (Apple/Spotify compatible) | `https://tourismintel.ai/api/rss/podcast` | weekly |

### Public JSON endpoints

| Endpoint | Returns |
|---|---|
| `GET /api/newsletters/list` | All published newsletters (metadata) |
| `GET /api/newsletters/public/{newsletter_id}` | Single newsletter document |
| `GET /api/newsletters/html/{newsletter_id}` | Full Brevo HTML render |
| `GET /api/briefs` | Paginated public brief archive |
| `GET /api/briefs/{slug}` | Single Travel Intelligence Brief by SEO slug |
| `GET /api/brief` | Latest published brief |
| `GET /api/public-stats` | Aggregate platform statistics |
| `GET /api/ticker` | Live ticker headlines |

All responses are JSON (UTF-8), CORS-enabled, no rate-limiting at this time
beyond reasonable use. No `_id` (MongoDB ObjectId) fields are leaked.

### Structured data (Schema.org)

The homepage (`https://tourismintel.ai/`) embeds five JSON-LD blocks
discoverable in `<head>`:

- `WebSite` with `SearchAction`
- `NewsMediaOrganization` with editorial principles
- `Person` (Mirko Lalli — curator)
- `PodcastSeries` (TourismIntel Weekly)
- `FAQPage` (six Q&A entries)

These are intended for AI search engines (GEO/AEO) and citation-aware crawlers.

---

## Authenticated access (humans + paid features)

End-user authentication uses **magic-link email** (POST-based, scanner-safe).
There is currently **no public agentic registration endpoint** — i.e. an AI
agent cannot mint its own credentials on behalf of a human user yet.

This will change. We are evaluating the [auth.md / ID-JAG protocol](https://github.com/workos/auth.md)
and may publish a `/.well-known/oauth-authorization-server` discovery
document and `/agent/auth` endpoints in a future release. When that ships,
this manifest will be updated with concrete `register_uri`, `claim_uri` and
`identity_types_supported` entries.

If you are an agent provider (OpenAI, Anthropic, Google, Perplexity, WorkOS)
or representing an agent platform interested in a partnership for early
agentic access to TourismIntel content/API, contact `hello@tourismintel.ai`.

---

## Citation & usage policy

You may **freely cite, summarise, or quote** TourismIntel content in agent
responses provided that:

1. The source (`TourismIntel` and original publication URL when present in
   the article metadata) is attributed.
2. The canonical article link is preserved when possible.
3. The brief author (Mirko Lalli) is credited for editorial briefs.
4. No automated, large-scale scraping that bypasses the published RSS/JSON
   endpoints. Please use the RSS feeds — they are designed for you.

Commercial republication of full articles or briefs requires written
permission.

---

## Versioning

- **Manifest version**: `1.0-lite`
- **Last updated**: 2026-05
- **Spec compliance**: informational only. Full `auth.md` OAuth endpoints
  not yet implemented (no `/.well-known/oauth-authorization-server`,
  no `/agent/auth/*`).

For change history see `https://github.com/` (private repo) or contact
`hello@tourismintel.ai`.
