qiaomu-markdown-proxy — скилл
Скилл читает ссылку и отдает агенту полный текст в Markdown: выбирает отдельный путь для страниц WeChat, документов Feishu, PDF и статей arXiv
- 509 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скилл запускает скрипты и ходит по сети на адреса, которые вы прислали
- Адреса ссылок передаются сторонним сервисам r.jina.ai и defuddle.md
- Для Feishu скилл использует секрет вашего приложения из переменных окружения
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/qiaomu-markdown-proxyОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл запускает скрипты и ходит по сети на адреса, которые вы прислали
- Адреса ссылок передаются сторонним сервисам r.jina.ai и defuddle.md
- Для Feishu скилл использует секрет вашего приложения из переменных окружения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл срабатывает, когда вы присылаете ссылку и просите прочитать, пересказать, перевести или переписать ее содержимое. Сначала он определяет тип адреса и выбирает свой маршрут, затем возвращает агенту чистый Markdown, с которым можно работать дальше в том же ходе. Статьи WeChat (mp.weixin.qq.com) идут через скрипт fetch_weixin.sh: он пробует прокси, а на странице с проверкой «окружение аномально» отключается на Playwright, чтобы не выдать заглушку за текст. Документы Feishu и Lark читает fetch_feishu.py через Open API: новые и старые документы, страницы вики, заголовки, списки, код, цитаты, формулы и картинки. Для статей arXiv и Hugging Face Papers extract_tex.py берет LaTeX-исходник и сохраняет разделы, формулы, рисунки и таблицы. PDF из сети или с диска разбирает extract_pdf.sh по цепочке marker-pdf, pdftotext, pypdf. Остальные страницы проходят каскад fetch.sh: r.jina.ai, затем defuddle.md, затем локальный `agent-fetch` и `defuddle` CLI. Ключи API не нужны, содержимое проверяется. Ссылки на YouTube скилл отдает отдельному скиллу, а если вы уже вставили текст целиком, он не вмешивается.
Для кого. Для авторов, редакторов и исследователей, которые отдают агенту ссылки на статьи, документы и статьи arXiv, чтобы получить из них текст для пересказа или анализа.
Подходит, если
- Нужно пересказать или переписать статью из WeChat, а обычное открытие страницы возвращает проверочную заглушку
- Документ Feishu или Lark надо превратить в Markdown вместе со списками, кодом и формулами
- Научную работу с arXiv требуется получить с сохранением формул и таблиц, а не плоского текста из PDF
- Из ссылки на PDF надо достать текст для перевода или анализа
- Обычную страницу сайта надо отдать агенту без навигации и рекламы
Не подходит, если
- Нужна расшифровка или субтитры видео с YouTube: скилл их исключает и отправляет к отдельному скиллу
- Вопрос решается обычным поиском, а не чтением конкретной страницы
- Вы уже вставили текст статьи в чат
- Документы лежат локально в формате, отличном от PDF: локальные файлы других типов скилл не берет
Пример запроса к агенту
Прочитай эту статью из WeChat и перескажи по пунктам: https://mp.weixin.qq.com/s/abc123Ограничения
Страницы идут через сторонние сервисы r.jina.ai и defuddle.md: адрес ссылки уходит им, поэтому закрытые страницы так не читают. Для Feishu нужны свое приложение, переменные FEISHU_APP_ID и FEISHU_APP_SECRET и права `docx`:`document`:`readonly`, для вики еще `wiki`:`wiki`:`readonly`. Для WeChat без прокси нужны Python 3.8 или новее, playwright, beautifulsoup4 и `lxml`. Для PDF хватит любой из утилит marker-pdf, pdftotext или pypdf. Автор просит соблюдать правила сайтов и авторские права, токены и `cookie` репозиторий не хранит. Текст README и скилла в основном китайский.
Как отключить. Удалите папку скилла qiaomu-markdown-proxy из каталога скиллов агента, например из ~/.agents/skills/. Для Feishu уберите из окружения FEISHU_APP_ID и FEISHU_APP_SECRET, если задавали их только для этого скилла.
Частые вопросы
Как поставить qiaomu-markdown-proxy в Claude Code?
Командой npx skills add joeseesun/qiaomu-markdown-proxy. Проверить установку можно по файлу ~/.agents/skills/qiaomu-markdown-proxy/SKILL.md.
Что делать, если страница WeChat возвращает «环境异常»?
Скрипт scripts/fetch_weixin.sh узнает такую страницу проверки и отказывается считать ее текстом, а вместо этого пробует Playwright. Для этого нужен установленный `chromium`: python3 -m playwright install `chromium`.
Какие права нужны приложению Feishu?
Для документов `docx`:`document`:`readonly`, для страниц вики дополнительно `wiki`:`wiki`:`readonly`. Идентификатор и секрет приложения передаются переменными FEISHU_APP_ID и FEISHU_APP_SECRET.
В каком порядке скилл пробует сервисы для обычных страниц?
Сначала r.jina.ai, он дает самое полное содержимое и ссылки на картинки. Если он вернул пусто, подключается defuddle.md с более чистым выводом и YAML-заголовком, потом локальные `agent-fetch` и `defuddle` CLI.
Какие форматы документов скилл читает, кроме веб-страниц?
PDF из сети или с диска (цепочка marker-pdf, pdftotext, pypdf), статьи arXiv и Hugging Face Papers через LaTeX-исходник, документы и вики Feishu и Lark через Open API.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл news-extractor достает из ссылки заголовок, текст, картинки и метаданные статьи с 12 новостных площадок и отдает JSON или Markdown без браузера
Свой сервис на Docker превращает ссылки, документы, YouTube и ветки Reddit в чистый Markdown. К агенту подключается как MCP, скилл Claude Code или API
CLI и скилл, через которые агент читает и ищет в Twitter, Reddit, YouTube, GitHub, Bilibili и Xiaohongshu без платных API
Скилл, который маршрутизирует вопрос к подходящей AI-платформе и через браузерную автоматизацию собирает ответ из ее родной поисковой выдачи
Скилл веб-поиска, поиска по X и чтения страниц для моделей без выхода в сеть: без регистрации и ключа, ответ в JSON со ссылками на источники
Скилл собирает обсуждения темы за 30 дней на восьми китайских площадках, ранжирует их и пишет отчет со ссылками, а еще показывает общие хит-парады
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| qiaomu-markdown-proxy (эта запись) | нет | 509 | ||
| Markdownify MCP Server | нет | не нужна | 2 996 | MCP-сервер, который превращает файлы и страницы в Markdown, а qiaomu-markdown-proxy выбирает маршрут под тип ссылки скриптами |
| Jina AI MCP | да | ключ необязателен | 892 | подключает сервисы Jina через MCP, а qiaomu-markdown-proxy использует r.jina.ai как первый шаг каскада и добавляет Feishu, WeChat и arXiv |
Коротко о README
README на английском и китайском описывает шесть типов ссылок и маршрут для каждого, предварительные условия, установку одной командой и примеры фраз для агента. Дальше идут приоритет прокси, поддержка документов Feishu, таблица типовых проблем с решениями и благодарности сервисам. В конце автор оговаривает границы: скилл ходит по ссылкам пользователя, не хранит токены и по умолчанию только читает.
Бейдж для README
Исходный SKILL.md
--- name: qiaomu-markdown-proxy description: "Read, fetch, extract, parse, or convert a URL or link into clean Markdown. Use FIRST whenever a user asks to read source content from a webpage, especially WeChat/微信公众号 mp.weixin.qq.com, Feishu/Lark docs, X/Twitter, PDFs, arXiv papers, or a URL that will feed a later summary, rewrite, article, podcast, or analysis. For WeChat and Feishu, prefer this specialist extractor over generic web open or generic content parsers. Exclude YouTube, pure web search, already-pasted text, and local non-PDF files." version: 2.1.0 --- # Markdown Proxy - URL to Markdown 将任意 URL 转为干净的 Markdown。支持需要登录的页面、PDF、专有平台。 ## URL Routing (先判断再执行) | URL Pattern | Route To | Reason | |-------------|----------|--------| | `mp.weixin.qq.com` | `scripts/fetch_weixin.sh` | 先代理，验证码页自动回退 Playwright | | `feishu.cn/docx/` `feishu.cn/wiki/` `larksuite.com/docx/` | `scripts/fetch_feishu.py` | 需飞书 API 认证 | | `youtube.com` `youtu.be` | `qiaomu-youtube-download` skill | YouTube 有专用工具链 | | `huggingface.co/papers/` | 提取 arXiv ID → `scripts/extract_tex.py` | HuggingFace 论文页实际是 arXiv 镜像 | | `arxiv.org/abs/` `arxiv.org/pdf/` | `scripts/extract_tex.py` | 从 LaTeX 源码提取结构化内容 (章节/图表/公式) | | `.pdf` (URL or local path) | `scripts/extract_pdf.sh` | PDF 专用提取 | | All other URLs | `scripts/fetch.sh` | 代理级联自动 fallback |