Инструкция: Опубликовать заметку в Telegraph

Trigger: «дай публичную ссылку на эту инструкцию», «сделай handoff в telegra.ph», «опубликуй коротко и пришли ссылку», «нужна ссылка для другого агента / для человека без доступа к школе».

Зачем

Telegraph (telegra.ph) — быстрый публичный буфер: markdown превращается в ссылку за секунды, без логина и MCP. Подходит для одноразового handoff (передать другому агенту, скинуть человеку без аккаунта). Не подходит для документов с долгой жизнью, совместной правкой или ролевыми правами — это в Школу или Trip2G.

Шаги

Подготовь markdown заметки. Чем проще структура — тем стабильнее рендер. Безопасные теги: h3, h4, p, pre, code, a, ul/ol/li, blockquote. Сложный HTML/таблицы — упрости.
Вырежи секреты. Пройдись чеклистом перед публикацией:
- токены, ключи API, cookies, session strings
- внутренние URL и id (если они дают доступ)
- имена/контакты людей, которые не давали согласия на публикацию
- пути к приватным файлам, скриншоты с приватными данными
Если хоть один пункт «есть» — стоп, замени на плейсхолдер.
Создай аккаунт Telegraph (если не сохранён access_token ранее):
```
POST https://api.telegra.ph/createAccount
{"short_name": "iiminion-agent", "author_name": "iiMinion"}
```
В ответе — access_token. Сохрани его в защищённое место (не в публичную заметку, не в школу). Без токена страницу нельзя будет редактировать или удалить.
Создай страницу:
```
POST https://api.telegra.ph/createPage
{"access_token": "<token>", "title": "<title>", "author_name": "iiMinion",
 "content": [<telegraph nodes>], "return_content": false}
```
content — массив узлов вида {"tag":"p","children":["..."]}. Конвертер markdown → telegraph nodes должен поддерживать минимальный набор тегов из шага 1.
Верни владельцу:
- URL страницы
- явно: «это публичная одноразовая ссылка, секретов внутри нет»
- явно: «токен правки сохранён у меня — могу обновить или удалить страницу по запросу»
Если инструкция важная — параллельно сохрани каноническую копию в школе через instructions/write_school_content. Telegraph — handoff, школа — память.
Залогируй в daily: [[instructions/publish_telegraph_note]] выполнена, опубликовано «» → , токен сохранён.

Пример вызова

curl -X POST https://api.telegra.ph/createPage \
  -d access_token=<TOKEN> \
  -d title='Handoff: запуск лендинга' \
  -d author_name='iiMinion' \
  --data-urlencode content='[{"tag":"p","children":["Шаг 1. Открой брифинг."]}]' \
  -d return_content=false

Проверка результата

Ссылка открывается из инкогнито без логина
В тексте страницы нет токенов, секретных URL, приватных контактов
access_token сохранён вне публичной страницы — могу позже отредактировать
Если параллельно нужна школа — копия лежит в instructions/ или behaviors/

Когда остановиться

В материале нашлись секреты, которые нельзя заменить плейсхолдером → не публикуй, передай через приватный канал
Документу нужны версии / совместная правка / роли → Telegraph не подходит, предложи школу или Trip2G
Запрошена цепочка постоянно живущих публикаций → подними вопрос об отдельной публичной поверхности (страница, mini-site), не плоди десятки telegra.ph

Типичные ошибки

Потерял access_token → страница становится «вечной и неуправляемой»; в редких случаях помогает повторный createAccount со старого short_name, но не рассчитывай на это
Опубликовал черновик с токеном/ключом внутри — лечится только удалением через editPage (нужен токен!) и сменой утёкшего секрета
Слишком сложный HTML / эмодзи в неподдерживаемых местах → рендер ломается; упрости до набора тегов из шага 1
Использовал Telegraph как замену базе знаний — через месяц никто не помнит, какая из десятка ссылок актуальна

Связано: behaviors/risky_actions (публикация наружу — шаг 5 как commit), insights/connector_types (Telegraph = «неофициальный API без auth»), insights/legibility (важное — в школу, не только в telegra.ph)

Источник: Trip2G research: «Инструкция для агентов: публичные telegra.ph заметки»