API ВЕГА
English

PrintFriendly для AI-редакторов

MCP-сервер PrintFriendly позволяет AI-редактору или агенту получать содержимое любой общедоступной веб-страницы в чистом Markdown — без рекламы, навигации и всплывающих окон. Кроме того, с его помощью можно преобразовать веб-страницу, HTML или Markdown в PDF, документ Word, Markdown, HTML или JSON. Сервер работает с Cursor, Claude Code, VS Code, Gemini CLI, Windsurf, Cline и любым другим клиентом, поддерживающим MCP через HTTP. Сервер доступен по адресу https://mcp.printfriendly.com; для работы нужен только API-ключ.

Получите бесплатный ключ

Создайте ключ на странице printfriendly.com/me/api-key. Бесплатный тариф включает 100 документов в месяц.

Везде, где ниже указано YOUR_API_KEY, подставьте свой ключ. Сервер принимает его в заголовке Authorization: Bearer YOUR_API_KEY или X-API-Key: YOUR_API_KEY.

Установка

Cursor

Кнопка откроет Cursor и добавит сервер, указав YOUR_API_KEY в качестве заполнителя. Откройте настройки Cursor, перейдите в раздел MCP и замените заполнитель своим ключом. Если кнопка не открывает Cursor, вставьте эту ссылку в браузер:

cursor://anysphere.cursor-deeplink/mcp/install?name=printfriendly&config=eyJ1cmwiOiJodHRwczovL21jcC5wcmludGZyaWVuZGx5LmNvbSIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciBZT1VSX0FQSV9LRVkifX0%3D

Либо добавьте сервер вручную в .cursor/mcp.json (или в ~/.cursor/mcp.json, чтобы он был доступен во всех проектах):

{
  "mcpServers": {
    "printfriendly": {
      "url": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Не храните настоящий ключ в системе контроля версий. В файле, который вы добавляете в репозиторий, укажите "Bearer ${env:PRINTFRIENDLY_API_KEY}" и задайте эту переменную окружения.

Этот репозиторий также является плагином Cursor: файл .cursor-plugin/plugin.json объявляет переменную PRINTFRIENDLY_API_KEY, а mcp.json использует её.

VS Code

Каждая кнопка открывает VS Code и добавляет сервер, указывая YOUR_API_KEY в качестве заполнителя. Выполните команду MCP: List Servers, выберите PrintFriendly, откройте конфигурацию сервера и замените заполнитель своим ключом.

Установить сервер можно и через терминал:

code --add-mcp '{"name":"printfriendly","type":"http","url":"https://mcp.printfriendly.com","headers":{"Authorization":"Bearer YOUR_API_KEY"}}'

Чтобы не хранить ключ в файле, добавьте следующий блок в .vscode/mcp.json. При первом запуске сервера VS Code запросит ключ.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "printfriendly-api-key",
      "description": "PrintFriendly API key",
      "password": true
    }
  ],
  "servers": {
    "printfriendly": {
      "type": "http",
      "url": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer ${input:printfriendly-api-key}"
      }
    }
  }
}

Claude Code

claude mcp add --transport http printfriendly https://mcp.printfriendly.com --header "Authorization: Bearer YOUR_API_KEY"

Добавьте --scope user, чтобы сервер был доступен во всех проектах. Выполните /mcp в Claude Code, чтобы проверить подключение: если ключ неверный, команда покажет ошибку 401.

Чтобы предоставить доступ к серверу всей команде, добавьте в проект файл .mcp.json и укажите в нём переменную окружения вместо ключа:

{
  "mcpServers": {
    "printfriendly": {
      "type": "http",
      "url": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer ${PRINTFRIENDLY_API_KEY}"
      }
    }
  }
}

Gemini CLI

Установите расширение. Gemini CLI запросит API-ключ и не сохранит его в файлах проекта:

gemini extensions install https://github.com/printfriendly/printfriendly-mcp

Позже изменить ключ можно командой gemini extensions config printfriendly.

Также можно добавить сервер без расширения:

gemini mcp add --transport http printfriendly https://mcp.printfriendly.com --header "Authorization: Bearer YOUR_API_KEY"

Команда добавит настройки в .gemini/settings.json текущего проекта. Чтобы сохранить их в ~/.gemini/settings.json, добавьте --scope user. Файл можно отредактировать и вручную. Gemini CLI подставляет значение $PRINTFRIENDLY_API_KEY в заголовки, поэтому ключ можно хранить в переменных окружения оболочки:

{
  "mcpServers": {
    "printfriendly": {
      "httpUrl": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer $PRINTFRIENDLY_API_KEY"
      }
    }
  }
}

Этот репозиторий также является расширением Gemini CLI: файл gemini-extension.json объявляет сервер и настройку PRINTFRIENDLY_API_KEY, а в GEMINI.md приведены краткие рекомендации о том, когда использовать каждый инструмент.

Windsurf

Откройте меню Actions на панели Cascade, выберите Open MCP config file и добавьте приведённый ниже блок. В Windsurf вместо url, используемого большинством клиентов, применяется параметр serverUrl. Windsurf также считывает переменные окружения, записанные в формате ${env:NAME}, поэтому ключ можно не хранить в файле:

{
  "mcpServers": {
    "printfriendly": {
      "serverUrl": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer ${env:PRINTFRIENDLY_API_KEY}"
      }
    }
  }
}

Вместо этого можно записать ключ непосредственно в файл, указав "Bearer YOUR_API_KEY".

Cline

Cline загружает настройки удалённых серверов из файла cline_mcp_settings.json. Чтобы открыть его, нажмите значок MCP Servers в верхней части панели Cline, перейдите на вкладку Configure и нажмите Configure MCP Servers. Для этого сервера в Cline необходимо указать "type": "streamableHttp": если тип не задан, клиент использует устаревший транспорт SSE.

{
  "mcpServers": {
    "printfriendly": {
      "type": "streamableHttp",
      "url": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },
      "disabled": false
    }
  }
}

Можно также передать Cline инструкции из файла llms-install.md и попросить настроить сервер.

Другие клиенты

Большинство MCP-клиентов считывают блок такого вида из файла настроек. Имя файла и внешний ключ зависят от клиента, но запись сервера остаётся той же.

{
  "mcpServers": {
    "printfriendly": {
      "type": "http",
      "url": "https://mcp.printfriendly.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Инструменты

read_page

Загружает веб-страницу и возвращает её основное содержимое в виде чистого Markdown, а также заголовок, автора, дату публикации и количество слов. Адреса ссылок не включаются, если вы не попросите об этом. Если страница слишком длинная, текст обрезается в конце абзаца, и об этом сообщается.

  • «Прочитай статью https://example.com/some-article и перечисли три основных тезиса».

  • «Прочитай эту страницу документации, сохрани ссылки, а затем перечисли все упомянутые в ней конечные точки API».

create_document

Создаёт документ на основе адреса веб-страницы, HTML или Markdown. Доступны форматы pdf, docx, markdown, html и json. Результат в формате PDF или Word предоставляется в виде ссылки для скачивания, действующей 48 часов.

  • «Создай PDF-файл из страницы https://example.com/recipe с форматом бумаги A4».

  • «Преобразуй эту страницу в документ Word: https://example.com/report».

  • «Сохрани этот Markdown в формате PDF с заголовком „Заметки о встрече“».

Ограничения

Бесплатный тариф включает 100 документов в месяц. Каждый успешный вызов любого из двух инструментов считается одним документом; неудачные вызовы не учитываются. Сервер обрабатывает только общедоступные страницы, поэтому содержимое страницы, доступной после входа в систему или оплаты, может не загрузиться. Платные тарифы с увеличенным лимитом документов доступны на странице printfriendly.com/api.

Ссылки