---
title: "For AI Agents & Tools"
description: "How AI assistants, LLM crawlers and agents can read hayorov.me: llms.txt, Markdown and JSON twins of every page, structured profile, talks and publications data, feeds, and an OpenAPI description."
url: https://hayorov.me/ai/
markdown_url: https://hayorov.me/ai/index.md
json_url: https://hayorov.me/ai/index.json
type: page
author: Alex Khaerov
author_url: https://hayorov.me/
date: 2026-10-04
lastmod: 2026-10-04
language: en
word_count: 403
---

# For AI Agents & Tools

> How AI assistants, LLM crawlers and agents can read hayorov.me: llms.txt, Markdown and JSON twins of every page, structured profile, talks and publications data, feeds, and an OpenAPI description.

This site is built to be read by machines as well as people. Everything below is static, cacheable, served with `Access-Control-Allow-Origin: *`, and needs no API key. If you are an LLM or an agent, start with [`/llms.txt`](https://hayorov.me/llms.txt).

## Start here

| Endpoint | What it is |
| -------- | ---------- |
| [`/llms.txt`](https://hayorov.me/llms.txt) | Index of the whole site in the [llms.txt](https://llmstxt.org/) format: who I am, every page and post with a one-line description, talks, publications, patents, links |
| [`/llms-full.txt`](https://hayorov.me/llms-full.txt) | Every page concatenated as Markdown, for one-shot ingestion |
| [`/openapi.json`](https://hayorov.me/openapi.json) | OpenAPI 3.1 description of the endpoints on this page, ready to import as tool or function definitions |

## Every page as Markdown or JSON

Append `index.md` or `index.json` to any page URL. HTML pages also advertise them with `<link rel="alternate" type="text/markdown">` and `<link rel="alternate" type="application/json">`.

| HTML | Markdown | JSON |
| ---- | -------- | ---- |
| `/about/` | [`/about/index.md`](https://hayorov.me/about/index.md) | [`/about/index.json`](https://hayorov.me/about/index.json) |
| `/posts/idps-part1/` | [`/posts/idps-part1/index.md`](https://hayorov.me/posts/idps-part1/index.md) | [`/posts/idps-part1/index.json`](https://hayorov.me/posts/idps-part1/index.json) |
| `/posts/` | [`/posts/index.md`](https://hayorov.me/posts/index.md) | [`/posts/index.json`](https://hayorov.me/posts/index.json) |

The Markdown twin carries YAML front matter (title, description, canonical URL, dates, tags) and a body in which galleries become image lists, embeds become links, and all links are absolute. The JSON twin carries the same metadata plus `content_markdown` and `content_text`.

## Structured data

Three pages carry a dataset under the `data` key of their JSON twin. The data lives in version-controlled YAML and renders both the HTML tables and these endpoints, so they never drift.

| Endpoint | `data` contains |
| -------- | --------------- |
| [`/about/index.json`](https://hayorov.me/about/index.json) | Profile: current role, experience timeline, education, certifications, patents, advisory roles and memberships, open source, links |
| [`/talks/index.json`](https://hayorov.me/talks/index.json) | Every talk, panel, workshop and podcast: year, title, URL, event, event URL, location, type |
| [`/publications/index.json`](https://hayorov.me/publications/index.json) | `articles` (Medium, Habr) and `offline` (books and registered electronic resources) |
| [`/posts/index.json`](https://hayorov.me/posts/index.json) | Every blog post: title, description, dates, tags, word count, and links to its Markdown and JSON |

## Feeds and indexes

- [`/feed.json`](https://hayorov.me/feed.json) — JSON Feed 1.1 with full HTML and plain-text content for every post
- [`/index.xml`](https://hayorov.me/index.xml) — RSS 2.0 with full content
- [`/sitemap.xml`](https://hayorov.me/sitemap.xml) — XML sitemap
- [`/index.json`](https://hayorov.me/index.json) — the client-side search index (title, section, summary, plain text, permalink for every page)

## Semantics in the HTML

Every HTML page embeds JSON-LD (`Person` and `WebSite` on the home page, `Article` and `BreadcrumbList` elsewhere), Open Graph and Twitter Card metadata, `rel="me"` links to my profiles, and a `rel="describedby"` link to `/llms.txt`.

## Crawling, quoting and contact

AI crawlers and assistants are explicitly allowed in [`/robots.txt`](https://hayorov.me/robots.txt). You are welcome to read, index, summarise and quote this site; please link back to the canonical page URL when you do. Something missing or wrong in the machine-readable data? Email [alex@hayorov.me](mailto:alex@hayorov.me).

---

Canonical HTML page: https://hayorov.me/ai/
Structured JSON: https://hayorov.me/ai/index.json
Site index for AI agents: https://hayorov.me/llms.txt