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

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 · Доступные датасеты

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

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

Записей: 3 484

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

Записей: 86

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

Записей: 72

02 · Методы API

Методы API

Метод	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+43af4829d934.
Давайте обратную ссылку на каноническую страницу каждой показанной записи.

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

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

Машиночитаемая политика атрибуции · Текущие права

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 · Коннекторы для агентов

Подключите Metkagram к OpenClaw или Hermes

Используйте встроенный read-only bridge для stdio. Он превращает публичный статический API в MCP-инструменты, требует Node.js 18+ и не требует API-ключа; каждый ответ сохраняет происхождение данных.

OpenClaw

Скачайте bridge и зарегистрируйте его как локальный MCP-сервер.
Проверьте через probe, что доступны шесть read-only инструментов.

mkdir -p ~/.local/share/metkagram
curl -fsSL https://metkagram.github.io/connectors/metkagram-mcp.mjs -o ~/.local/share/metkagram/metkagram-mcp.mjs

openclaw mcp add metkagram \
  --command node \
  --arg ~/.local/share/metkagram/metkagram-mcp.mjs \
  --include 'metkagram_*'

openclaw mcp doctor metkagram --probe

Справка OpenClaw MCP ↗

Hermes

Скачайте тот же bridge и добавьте показанный блок в конфигурацию MCP.
Замените /home/YOU на абсолютный путь на машине, где работает Hermes.

mkdir -p ~/.local/share/metkagram
curl -fsSL https://metkagram.github.io/connectors/metkagram-mcp.mjs -o ~/.local/share/metkagram/metkagram-mcp.mjs

# Add to ~/.hermes/config.yaml
mcp_servers:
  metkagram:
    command: node
    args: ["/home/YOU/.local/share/metkagram/metkagram-mcp.mjs"]
    tools:
      include: [metkagram_list_patterns, metkagram_get_pattern, metkagram_list_sets, metkagram_get_set, metkagram_search_index, metkagram_list_annotations]
      prompts: false
      resources: false

# Then restart Hermes, or run /reload-mcp in a session.

Справка Hermes MCP ↗

Коннектор открывает только read-операции. Когда агент показывает запись, сохраните атрибуцию Metkagram и канонический URL.

Попробуйте

Найди три паттерна B2–C1 для вежливой просьбы. Дай примеры, переводы на русский и канонический источник Metkagram для каждого.

07 · Загрузки

Загрузки

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

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

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