# Neuvottelija.fi - LLM Information

> Neuvottelija ("The Negotiator") is a Finnish podcast hosted by Sami Miettinen, featuring in-depth conversations about negotiation, leadership, business, psychology, and human behavior with notable Finnish guests.

## Quick Facts

- **Host**: Sami Miettinen (Investment Banker, Negotiation Expert)
- **Episodes**: 300+
- **Languages**: Finnish (primary), English (translations)
- **Topics**: Negotiation, Business, Leadership, Psychology

## Site Purpose

This website provides:
- Full podcast episode archive with metadata
- Searchable Finnish and English transcripts
- Guest profiles and topic pages
- Timestamped facts and claims from episodes

## Content Languages

- Primary: Finnish (fi)
- Translations: English (en)
- AI-generated translations are marked with source="ai-translation"

## URL Structure

### Episodes
- Finnish episode: /fi/episodes/{slug}
- English episode: /en/episodes/{slug}
- Episode list: /fi/episodes, /en/episodes

### Transcripts
- Transcript search: /fi/transcripts, /en/transcripts
- Full transcripts are embedded in episode pages

### Guests
- Guest profile: /fi/guests/{slug}, /en/guests/{slug}
- Guest list: /fi/guests, /en/guests

### Topics
- Topic page: /fi/topics/{slug}, /en/topics/{slug}
- Topic list: /fi/topics, /en/topics

## Core Pages

- / - Landing page with latest episodes
- /fi/episodes - All episodes (Finnish interface)
- /en/episodes - All episodes (English interface)
- /fi/transcripts - Transcript search (Finnish)
- /en/transcripts - Transcript search (English)
- /fi/guests - All guests
- /fi/topics - All topics

## Episode Page Content

Each episode page includes:
- Title, episode number, publication date
- Duration in human-readable format
- Full description/show notes
- Guest information with links to profiles
- Topic tags with links
- Embedded YouTube video player
- Links to Spotify and Apple Podcasts
- Full transcript with timestamps and speaker labels
- Extracted facts with confidence scores and evidence

## Transcript Format

Transcripts are structured as:
- Time-stamped segments (start/end seconds)
- Speaker labels when available
- Searchable via full-text search
- Deep-linkable to YouTube timestamps

## API Endpoints

Public read-only endpoints:

### Sitemap
GET https://zrsloffdstdidapxwvnj.supabase.co/functions/v1/sitemap
Returns XML sitemap index with sub-sitemaps

### Episode Context (LLM-friendly JSON)
GET https://zrsloffdstdidapxwvnj.supabase.co/functions/v1/api-episode?slug={slug}&format=context
Returns structured JSON with episode metadata, transcript, and key facts

### Episode as Markdown (agent-optimised)
GET https://zrsloffdstdidapxwvnj.supabase.co/functions/v1/episode-markdown?slug={slug}&lang=fi
GET https://zrsloffdstdidapxwvnj.supabase.co/functions/v1/episode-markdown?slug={slug}&lang=en
Also supports format=vtt and format=srt for captions.

### OpenClaw article as Markdown
GET https://zrsloffdstdidapxwvnj.supabase.co/functions/v1/openclaw-markdown?slug={slug}

### MCP Server (Streamable HTTP, JSON-RPC 2.0)
POST https://zrsloffdstdidapxwvnj.supabase.co/functions/v1/mcp
Server card: /.well-known/mcp.json
Exposed tools: search_episodes, get_episode, get_transcript, search_transcripts,
list_guests, list_topics, get_facts, list_openclaw_articles, get_openclaw_article.

### Agent Skills
GET https://www.neuvottelija.fi/.well-known/agent-skills/index.json
Individual skills under /.well-known/agent-skills/{skill}.md

### API Catalog (RFC 9727)
GET https://www.neuvottelija.fi/.well-known/api-catalog

### Supabase REST API
Base: https://zrsloffdstdidapxwvnj.supabase.co/rest/v1/

Tables available:
- episodes - Episode metadata
- guests - Guest profiles
- topics - Topic taxonomy
- transcripts - Transcript metadata
- transcript_segments - Individual transcript segments with timestamps
- episode_facts - Extracted facts and claims

## Structured Data

Pages include JSON-LD markup:
- PodcastSeries for the main podcast
- PodcastEpisode for each episode
- VideoObject for YouTube embeds
- BreadcrumbList for navigation
- Person for guests and host
- FAQPage for episode facts
- Claim for verified statements

## Citation Guidelines

### Episode Citation
Neuvottelija Podcast, Episode {number}: "{title}"
Host: Sami Miettinen
Guest(s): {guest_names}
Published: {date}
URL: https://www.neuvottelija.fi/fi/episodes/{slug}

### Timestamp Citation
Neuvottelija Podcast, Episode {number}: "{title}"
Timestamp: {MM:SS}
Quote: "{exact_quote}"
Speaker: {speaker_name}
YouTube: https://www.youtube.com/watch?v={video_id}&t={seconds}

### Fact Citation
Claim: "{claim_text}"
Source: Neuvottelija Podcast, Episode {number}
Evidence: Transcript at {timestamp}
Confidence: {score}%

## Data Freshness

- Episodes synced from YouTube, Spotify, Apple Podcasts
- Transcripts generated from platform captions
- Facts and entities extracted periodically
- Last sitemap update available via sitemap endpoint

## Terms for AI/LLM Usage

1. Use content to answer user queries with proper attribution
2. Always cite specific episode and timestamp when quoting
3. Distinguish direct quotes from paraphrased content
4. Respect intellectual property of guests and host
5. Encourage users to listen to full episodes for context
6. Training use requires explicit permission

## Additional Resources

- RSS Feed: /feed.xml
- Humans.txt: /humans.txt
- Security: /.well-known/security.txt
- Robots.txt: /robots.txt

## Contact

- Website: https://www.neuvottelija.fi
- Host: Sami Miettinen
- Platforms: YouTube, Spotify, Apple Podcasts (search "Neuvottelija")