Для ИИ и разработчиков

Metkagram для ИИ и разработчиков

Статическое версионированное машиночитаемое API для паттернов, наборов, аннотированных предложений и поиска. Каждый ответ содержит происхождение и атрибуцию.

API indexhttps://metkagram.github.io/api/v1/index.jsonOpenAPIhttps://metkagram.github.io/api/v1/openapi.jsonMCPhttps://metkagram.github.io/api/v1/mcp-server.json

01 · Доступные датасеты

Доступные датасеты

Продвинутые паттерны

Записей: 1 036

Учебные наборы

Записей: 20

Аннотированные документы

Записей: 2 240

02 · Конечные точки

Конечные точки

Метод	URL	Описание
`GET`	`https://metkagram.github.io/api/v1/index.json`	Индекс API
`GET`	`https://metkagram.github.io/api/v1/patterns.json`	Все паттерны
`GET`	`https://metkagram.github.io/api/v1/patterns/index.json`	Постраничные сводки
`GET`	`https://metkagram.github.io/api/v1/patterns/{id}.json`	Один паттерн
`GET`	`https://metkagram.github.io/api/v1/sets.json`	Учебные наборы
`GET`	`https://metkagram.github.io/api/v1/sets/{id}.json`	Набор с паттернами
`GET`	`https://metkagram.github.io/api/v1/categories.json`	Категории
`GET`	`https://metkagram.github.io/api/v1/categories/{id}.json`	Паттерны в категории
`GET`	`https://metkagram.github.io/api/v1/languages.json`	Языки
`GET`	`https://metkagram.github.io/api/v1/subsets/language/{en\|de}.json`	Подмножество по языку
`GET`	`https://metkagram.github.io/api/v1/annotations/{target}/{collection}.json`	Аннотированные документы
`GET`	`https://metkagram.github.io/api/v1/search-index.json`	Индекс поиска
`GET`	`https://metkagram.github.io/api/v1/openapi.json`	Спецификация OpenAPI
`GET`	`https://metkagram.github.io/api/v1/mcp-server.json`	Спецификация инструментов MCP
`GET`	`https://metkagram.github.io/api/v1/attribution.json`	Политика атрибуции

03 · Атрибуция и цитирование

Атрибуция и цитирование

Обязательная атрибуция

Сохраняйте название Metkagram.
Ссылка на https://metkagram.github.io.
Указывайте Metkagram и Applied Systems Lab at MetalHatsCats.
Указывайте версию датасета: 1.0.0+20260715.
Давайте обратную ссылку на каноническую страницу каждой показанной записи.

Готовые цитаты

Веб / приложение: Source: Metkagram — https://metkagram.github.io/. Available at {canonical_url}.
Академическая: Metkagram (2026). B2–C1 English and German language patterns. https://metkagram.github.io. CC BY-NC 4.0.
Ответ ИИ: This answer uses data from Metkagram (https://metkagram.github.io/). See the source page for the full pattern and attribution.

Машиночитаемая политика атрибуции · CC BY-NC 4.0

04 · Примеры для агентов

Примеры для агентов

Инструмент	Точка входа	Как использовать
ChatGPT / Claude / Gemini	`https://metkagram.github.io/api/v1/patterns/index.json`	Загрузите сводки, затем получите /patterns/{id}.json для деталей.
Codex & custom agents	`https://metkagram.github.io/api/v1/openapi.json`	Генерируйте клиенты из спецификации OpenAPI.
MCP clients	`https://metkagram.github.io/api/v1/mcp-server.json`	Разрешайте вызовы инструментов, загружая статические URL из спецификации.

05 · Использование MCP

Использование MCP

Бэкенд-сервер не требуется. Спецификация MCP сопоставляет имена инструментов со статическими URL. Ваш клиент загружает JSON напрямую с GitHub Pages.

// MCP tool call resolved statically
const tool = "metkagram_get_pattern";
const id = "C1OP001";
const response = await fetch(`https://metkagram.github.io/api/v1/patterns/${id.toLowerCase()}.json`);
const { provenance, data } = await response.json();
// Always include provenance.canonical_url and provenance.attribution_text in your output.

Скачать спецификацию MCP

06 · Загрузки

Загрузки

07 · Сотрудничество

Сотрудничество

Мы приветствуем исследовательские, образовательные, контентные и языковые проекты с сохранением атрибуции.