PrintFriendly

AI エディター向け PrintFriendly

PrintFriendly の MCP サーバーを使うと、AI エディターやエージェントで、広告、ナビゲーション、ポップアップを除いた、読みやすい Markdown として公開ウェブページを読み込めます。また、ページ、HTML、Markdown を PDF、Word、Markdown、HTML、JSON ドキュメントに変換できます。Cursor、Claude Code、VS Code、Gemini CLI、Windsurf、Cline、および HTTP 経由で MCP に対応するその他のクライアントで動作します。サーバーは 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 を追加します。Claude Code 内で /mcp を実行して接続を確認してください。キーが間違っている場合は、そこに 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 で各ツールをいつ使うかについて Gemini に簡潔なメモを提供しています。

Windsurf

Cascade パネルで Actions メニューを開き、Open MCP config file を選択して、以下のブロックを追加します。Windsurf では、多くのクライアントが url を使うところで serverUrl を使い、${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 からリモートサーバーを読み込みます。ファイルを開くには、Cline パネル上部にある MCP Servers アイコンをクリックし、Configure タブを開いて Configure MCP Servers をクリックします。このサーバーには "type": "streamableHttp" が必要です。type を指定しない場合、Cline は旧式の SSE トランスポートを使用すると判断します。

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

llms-install.md の手順を Cline に渡して、サーバーを設定するよう依頼することもできます。

その他のクライアント

ほとんどの MCP クライアントは、設定ファイルから次のようなブロックを読み込みます。ファイル名と外側のキーはクライアントによって異なりますが、サーバーのエントリーは同じです。

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

ツール

read_page

ウェブページを読み込み、主要な内容を整形された Markdown として返します。タイトル、著者、日付、文字数も含まれます。リンクのアドレスは、指定しない限り省略されます。また、非常に長いページは段落の途中で切り上げられ、その旨が示されます。

• 「https://example.com/some-article を読み、主なポイントを3つ教えてください。」
• 「このドキュメントページを読み、リンクを残したうえで、記載されている API エンドポイントをすべて列挙してください。」

create_document

ウェブページのアドレス、HTML、または Markdown からドキュメントを作成します。pdf、docx、markdown、html、json を選択できます。PDF と Word の結果は、48 時間有効なダウンロードリンクで返されます。

• 「https://example.com/recipe を A4 用紙の PDF にしてください。」
• 「このページを Word 文書にしてください：https://example.com/report」
• 「この Markdown を Meeting notes というタイトルの PDF として保存してください。」

制限

無料プランでは、月に100件のドキュメントを利用できます。どちらかのツールの呼び出しが成功するたびに、ドキュメント1件として数えられます。失敗した呼び出しは数えられません。サーバーが読み取るのは公開ページのみのため、ログインが必要なページや有料ページは空の結果になる場合があります。ドキュメント数を増やせる有料プランについては、printfriendly.com/api をご覧ください。

リンク

• ドキュメント
• 利用規約
• プライバシーポリシー
• MITライセンス