docshare

docshare

PDF を誰かに渡し、その後どうなったかを把握できます。 docshare は EveryPage と連携します。ドキュメントを一度アップロードし、発行された追跡リンクを共有すると、その後はリンクを通じたすべての閲覧、ダウンロード、メールアドレス入力ゲートの完了が記録されます。バリアントを使えば、送信した正確な宛先ごとに記録できます。

ツールは 15 個あります。共有とライフサイクル： everypage_share_pdf はローカルパスまたは https URL から PDF をアップロードし、同じ呼び出しで共有設定を適用できます。everypage_list_files と everypage_get_file では共有済みのファイルを確認できます。everypage_update_file_settings はパスコード、有効期限、ダウンロード許可、ビューアーモード、メールアドレス入力ゲート、閲覧上限、ページ範囲、またはスラッグを変更します。everypage_replace_content は、リンクとその履歴を維持したまま、公開中のリンクの背後にある PDF を差し替えます。また、everypage_delete_file はドキュメントをゴミ箱に移動します。明示的に指定すれば、完全に消去することもできます。

閲覧状況：everypage_get_readership は、誰がドキュメントを読んだか、どこまで読んだか、どこで閲覧を中断したかを報告します。everypage_list_events は、ポーリングカーソルを次の呼び出しへ引き継ぎながら、最近の閲覧、ダウンロード、または取得したリード情報をストリーム配信します（カーソルは、作成元と同じ種類のストリームでのみ機能します）。

バリアントと Webhook：everypage_create_variants は、名前を指定した受信者ごとに追跡リンクを作成します。everypage_list_variants、everypage_update_variant、everypage_delete_variant でそれらを管理できます（受信者名の GDPR に準拠した墨消しも含みます）。everypage_list_webhooks と everypage_manage_webhook では Webhook エンドポイントと配信状況を管理できます。また、everypage_account では接続済みアカウント、そのプラン、およびプランで利用できる機能を確認できます。

ファイル引数は柔軟な形式に対応しています。UUID、短縮リンク ID、または完全な共有 URL を貼り付けてください。/embed/ リンクや ?via= を含むリンクも使えます。アップロードはマシンから送信される前に検証されます。バイト列は PDF のマジックナンバー %PDF- で始まる必要があります。また、https URL から取得する PDF は EveryPage のキーを使わずにダウンロードされます。このキーが送信されるのは EveryPage 自体に対してのみです。

Configuration

export EVERYPAGE_API_KEY="..."            # required
export EVERYPAGE_BASE_URL="https://everypage.co"   # optional override
export EVERYPAGE_READ_ONLY="true"         # optional: read tools only

EVERYPAGE_API_KEY がない場合、リクエストを行う前に、すべてのツールが EVERYPAGE_API_KEY is not set で失敗します。EVERYPAGE_READ_ONLY=true の場合、一覧に表示されるのは 7 つの読み取りツール（everypage_list_files、everypage_get_file、everypage_get_readership、everypage_list_events、everypage_list_variants、everypage_list_webhooks、everypage_account）のみで、それ以外のツールを呼び出すと拒否されます。

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドです。

npx @reneturcios/docshare everypage_share_pdf '{"source":"./deck.pdf","settings":{"requireEmail":true}}'
npx @reneturcios/docshare everypage_list_events '{"type":"view","limit":20}'
npx @reneturcios/docshare everypage_create_variants '{"file":"https://everypage.co/s/abc123?via=email","labels":["Ana","Ben"]}'
npx @reneturcios/docshare --version

出力はツールの結果テキスト（通常はアップストリームの JSON）です。終了コード：成功時は 0、実行時エラー（検証エラーやアップストリームの失敗を含む）時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/docshare mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "docshare": {
      "command": "npx",
      "args": ["-y", "@reneturcios/docshare", "mcp"],
      "env": { "EVERYPAGE_API_KEY": "..." }
    }
  }
}

Docker

docker run -i -e EVERYPAGE_API_KEY=... ghcr.io/cloudcorprecords/docshare
docker run --rm -e EVERYPAGE_API_KEY=... ghcr.io/cloudcorprecords/docshare everypage_account '{}'

Development

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch + fake file reader, no network)
npm run dev     # run the CLI from source

License

MIT — Copyright (c) 2026 Rene Turcios