コンテンツにジャンプ
概要 概要 ニュース ニュース
共有

Cookbook

コピー用プロンプト。 完成済みAPI例。

Document AI、Data APIs、IDEワークフロー用の28プロンプト — コピー、貼り付け、コードを取得。

PaperOffice llms.txtはすべての現代的なLLMを読み取り:Claude、CursorおよびあなたのIDEが残りを書きます。

完成済みプロンプト28個 本物のエンドポイント RESTとMCP

統合

llms.txt から継続的インテグレーションへ

3つのステップ: ドキュメントへのリンク、意図の明示、コードの採用。

  1. llms.txt を貼り付け

    Claude、Cursor、または IDE に貼り付けます。

  2. 意図を伝える

    何を構築するか、またはこのページからのプロンプト。

  3. コードを書かせる

    IDEが実行中の統合を提供します。

Document AI

ドキュメントの読み取り、確認、送信

プロンプトをコピーしてClaudeまたはCursorに貼り付ける — 完了。

IDP請求書 + AI-OCR + バウンディングボックス

文書内の位置を含む請求書フィールドを抽出します。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build me an invoice extractor that:
1. Uploads a PDF via POST /job/add/workflow (multipart, field file_1)
2. Uses idp_collection=invoice, processing_lane=instant (sync)
3. Reads every field from result.pages_idp[0].suggested_fields
   (keys like _supplier_name, _total_amount, _invoice_date)
   and the boxes from result.pages_aiocr.pages
4. Renders a verification view highlighting each value
   at its bounding box position

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

AI-OCR — 画像/PDFからのテキスト

POST /job/add/paperoffice_aiocr___generate (ocr_mode=complete) で全文を取得。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Write a minimal script that:
1. Sends an image or PDF to POST /job/add/paperoffice_aiocr___generate
   (multipart, field file_1)
2. Uses ocr_mode=complete and processing_lane=instant (sync)
3. Prints the extracted text from result ?? job_result (pages)

Modes: complete (+tables), grid (+bounding boxes), text (plain).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

AI PDF分割 — 結合PDFの分離

文書境界を検出し、個別ファイルに命名。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a splitter for large batch PDFs (up to 3000 pages):
1. POST /job/add/workflow with template=pdf_ai_split (multipart, field file)
2. naming_instruction=Dokumenttyp_Datum_Absender,
   locale=de_DE, processing_lane=instant
3. List every created document from the result
   (suggested filename + page range)

The AI detects document boundaries automatically.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

文書匿名化 — PIIの黒塗り

名前、IBAN、住所を検出および編集。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt
Also use llms-full.txt for anonymize parameters (scenario, apply).

Build a GDPR anonymizer (preview → apply):
1. POST /job/add/workflow template=document_anonymize_preview (field file)
2. Set scenario=gdpr_auskunft (or externe_weitergabe / finanzdaten),
   redact_categories=all, optional whitelist / custom_redact
3. client_wait=false then poll GET /job/get/{job_id}
4. Show detected_pii.redact_box_ids + simplified_boxes
5. Apply: POST /job/add/paperoffice_dataripper___redact_image
   with files + bounding_boxes + redact_boxes from the preview
   (or MCP: po_anonymization_pii_detect → po_anonymization_redaction_apply
   with preview_job_id)
Optional one-shot: REST template=document_anonymize OR MCP po_anonymization_anonymize
  (no HITL; pass scenario/whitelist).
Redact Agent: POST /documents/redact-agent-run or MCP po_documents_redact_agent_run.

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

音声TTS — テキストからオーディオへ

voice=Nadja などによる同期MP3。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a text-to-speech generator:
1. POST /job/add/paperoffice_voice___tts with text=..., voice=Nadja,
   output_format=mp3
2. output=url and processing_lane=instant for a synchronous audio link
3. Play or download the audio URL from result ?? job_result

Voices: Nadja, Thomas, Anna, Hans (DE) + 100+ more.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDP契約 + AI-OCR + バウンディングボックス

文書内の位置情報を含む契約フィールドを抽出。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a contract extractor that:
1. Uploads a PDF via POST /job/add/workflow (multipart, field file_1)
2. Uses idp_collection=contract, processing_lane=instant (sync)
3. Reads parties, dates and notice period from
   result.pages_idp[0].suggested_fields (value + bounding box)
4. Renders a verification view with bounding boxes

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

電子署名 — 署名リクエストの作成

署名者を招待し、ステータス/リマインダーを管理します。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an e-signature request flow:
1. Ensure the document has a pofid in PaperOffice
2. POST /signatures/create with document_pofid (or pofid)
   and a signers array (name + email per signer)
3. Return the signature request id and status
4. Optionally POST /signatures/remind for pending signers

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

デジタル書留 — メールで送信

PDFパスワード(メールまたはSMS)と配送記録による安全な配達。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a secure document delivery (digital registered mail):
1. POST /document_delivery/create_and_send with:
   pofids: ["POFID_HERE"],
   recipient_email, optional recipient_name,
   subject, optional message
2. security_mode=link → PDF password in the same email
   security_mode=secure_sms → link by email, password by SMS
   (requires recipient_phone in E.164, e.g. +49170…)
3. Show delivery_id and that access events are logged
   (Versandhistorie / delivery log)

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

データ&セキュリティ APIs

位置、リスク、マスターデータを確認

ジオコーディング、天気、フィンガープリント、USt-IdNr. など — プロンプトとして。

ジオコーディング — フォワード / リバース / 自動補完

住所 ↔ 座標。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a geocoding helper that:
1. Forward: GET /geocoding/forward?q=...&lang=de
2. Reverse: GET /geocoding/reverse?lat=...&lon=...
3. Autocomplete: GET /geocoding/autocomplete?q=...
4. Prints display_name, lat, lon and credits_billed

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

天気 — 現在 + エアークオリティ

現在の天気情報、課金を含む。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a weather lookup that:
1. Calls GET /weather/current?lat=...&lon=...&lang=de
2. Shows temperature, condition text and air quality if present
3. Displays credits_billed from the response

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IP2Location — IP → 場所

IPからの場所、オプションで天気。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an IP intelligence client that:
1. Calls GET /ip2location/full (empty ip = visitor IP)
2. Extracts country, city, geo_lat/lon, ISP
3. Optionally chains weather from the same response

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

デバイスフィンガープリント — 訪問者ID

訪問者IDと信頼度。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a device fingerprint check that:
1. Collects client signals in the browser
2. POSTs to /fingerprint/identify
3. Returns visitor_id / confidence for fraud checks

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

フェイクメール検出器 — ディスposableチェック

使い捨てメールとリスクスコア。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an email risk checker that:
1. Validates an address via the Fake Email Detector endpoint
2. Flags disposable / role / invalid domains
3. Returns a clear allow/deny recommendation

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

VPN / 匿名性チェック

VPN、プロキシ、Tor、データセンター。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a VPN/proxy detector that:
1. Calls GET /ip2location/vpn?ip=...
2. Normalizes is_vpn, is_proxy, is_tor, is_datacenter flags
3. Shows a clear risk badge for the visitor

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

VATバリデーター — EU VAT ID

有効性と企業情報。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a VAT ID validator that:
1. Checks an EU VAT number via the VAT validator endpoint
2. Returns company name and address when valid
3. Handles invalid / not-found responses cleanly

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

通貨交換 — 実為替レート

現在レートによる換算。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a currency converter that:
1. Calls the currency exchange endpoint (from, to, amount)
2. Shows rate and converted amount
3. Caches the last rate for the UI

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDE & AI ツール

Claude、Cursor およびあなたの IDE 向け

IDE で動作するプロンプト — MCP サーバー付き。

IDP 請求書パイプライン + バウンディングボックス + CSV

検証座標付きバッチ抽出。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a Python script that:
1. Takes a folder of invoice PDFs
2. Extracts all fields using POST /job/add/workflow with idp_collection=invoice
3. Returns bounding boxes for verification (result.pages_aiocr)
4. Exports to CSV

Important: Use file_1 for uploads; fields live in result.pages_idp[0].suggested_fields.
Handle sync (HTTP 200 with result) and async (HTTP 202 → poll GET /job/get/{job_id}).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

MCP サーバー — IDE 内の Document AI

MCP を接続し、ワークスペースから文書を処理。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Help me set up the MCP Server for PaperOffice in Cursor.
I want to use Document AI directly in my IDE.

Show me:
1. How to configure the MCP connection (URL https://mcp.paperoffice.ai/cursor)
2. Available tools via tools/list
3. How to process documents from my workspace

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

音声エージェント — STT + TTS

音声入力を処理し、音声で回答する。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a voice agent that:
1. Takes audio input (Speech-to-Text)
2. Processes the text
3. Generates audio response (Text-to-Speech)

Use these pipelines:
- STT: POST /job/add/paperoffice_voice___stt (audio_file)
- TTS: POST /job/add/paperoffice_voice___tts (text, voice=Nadja,
  output_format=mp3, output=url)
- Use processing_lane=instant for a synchronous response.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

不正検出 —フィンガープリント + IP

デバイスフィンガープリントとGeo/IPシグナルを確認する。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a fraud detection system that:
1. Checks device fingerprints
2. Validates IP geolocation
3. Detects suspicious patterns

Use the Security & Data AI endpoints.
These are instant APIs (no polling needed).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

バッチAI PDF分割

大規模PDFフォルダを非同期で分割する。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a batch processor that:
1. Takes a folder of large PDFs (up to 3000 pages each)
2. Uses POST /job/add/workflow with template=pdf_ai_split
3. Uses naming_instruction for smart filenames
4. Handles async jobs (HTTP 202) by polling GET /job/get/{job_id}

Use locale=de_DE for German document types.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

文書分類器 — OCR + フォルダ

OCRを実行し、分類してサブフォルダに整理する。

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a document classifier that:
1. Watches a folder for new PDFs
2. Uses OCR (POST /job/add/paperoffice_aiocr___generate, ocr_mode=complete)
   to extract text
3. Classifies into: invoice, contract, receipt, correspondence
4. Moves files to category subfolders
5. Logs results to classification_log.csv

Authenticate with: Authorization: Bearer po_ut_YOUR_API_KEY.
processing_lane=instant for a synchronous response.

エンドツーエンド

完全なパイプライン

入力からエクスポートまで — すべてのステップを同じプロンプトで。

IDP請求書→会計エクスポート

PDFアップロード → AI-IDP + バウンディングボックス → 検証 → CSVエクスポート

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an accounts-payable pipeline:
1. Watch a folder for incoming invoice PDFs
2. Extract fields via POST /job/add/workflow (file_1,
   idp_collection=invoice, processing_lane=instant)
3. Flag every field with confidence < 0.9 for manual review,
   including its bounding box for the verification UI
   (result.pages_idp[0].suggested_fields + result.pages_aiocr)
4. Export supplier, total, date and IBAN as CSV for the accounting import

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDP契約書 + 期限アラート

契約書アップロード → キーワード抽出 → Knowledge Graph → 警告メッセージ

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a contract analyzer:
1. Upload contracts via POST /job/add/workflow (file_1,
   idp_collection=contract, processing_lane=instant)
2. Extract parties, start date, end date and notice period
   from result.pages_idp[0].suggested_fields (each with a bounding box)
3. Store the key terms in a knowledge graph
4. Alert me 90 days before a notice period expires

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

PDF変換 — Word / PowerPoint / PDF/A

PDFのアップロード → フォーマットを選択 → 変換 → ダウンロード

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a PDF converter service:
1. One pipeline per target format (field file_1):
   POST /job/add/pdfstudio___pdf_to_word | pdfstudio___pdf_to_powerpoint |
   pdfstudio___pdf_to_pdfa | pdfstudio___pdf_to_webp
2. processing_lane=instant for a synchronous response
3. Return the download URL from result ?? job_result

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Webhooks — job.completedの処理

Webhookを登録 → ドキュメントを送信 → イベントを受信 → 処理

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a webhook event handler:
1. Register a webhook via POST /webhooks/subscribe
   (url, events: ["job.completed", "job.failed"], secret)
2. Verify the HMAC-SHA256 signature of every delivery
   with the subscription secret (see llms-full.txt, webhooks)
3. Process the payload whenever job.completed arrives

Note: webhooks always require a token (account binding).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

OCR → TTS — ドキュメントからオーディオへ

ドキュメントのOCR → テキストの前処理 → TTSの生成 → オーディオの保存

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a document-to-audio pipeline:
1. OCR via POST /job/add/paperoffice_aiocr___generate
   (file_1, ocr_mode=complete, processing_lane=instant)
2. Split the extracted text (result ?? job_result, pages) into 5000-character chunks
3. TTS per chunk: POST /job/add/paperoffice_voice___tts (text, voice=Nadja,
   output_format=mp3, output=url, processing_lane=instant)
4. Save all returned audio URLs as a playlist

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

バッチOCR → CSVエクスポート

フォルダのスキャン → バッチOCR → テキストの収集 → CSVエクスポート

プロンプト
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a batch OCR-to-CSV exporter:
1. Scan a folder for PDF/PNG/JPG/TIFF/WEBP files
2. For each file: POST /job/add/paperoffice_aiocr___generate
   (file_1, ocr_mode=complete, processing_lane=instant)
3. Collect filename, page_count, text preview and confidence
4. Write everything to ocr_results.csv

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

次のステップ

APIへ進む

llms.txtとPlayground — 近道なしで。

RESTおよびMCP用のトークン credits_billedを含むレスポンス 独自のEUインフラストラクチャ
動画

Cookbook の実演

PaperOffice API が実際にどのように機能するかを動画でご覧ください。

Cookbook の実演

よくある質問

重要な情報まとめ

SDK は必要ですか?

いいえ。PaperOffice API は純粋な REST です:エンドポイント1つ、Bearer トークン、multipart/form-data のみです。IDE やエージェント向けに MCP サーバーも提供しています。

なぜllms.txtがすべてのプロンプトに含まれているのですか?

llms.txtはAPIドキュメントの機械可読版です。モデルはこれを使用してエンドポイント、パラメータ、および応答形式を読み取り、フィールドを勝手に作成しません。

どのキーを入力すればよいですか?

プレフィックス「po_ut_」を持つユーザートークンを使用します。PaperOfficeアプリの[アカウント] → [API]で確認できます。プロンプト内の「po_ut_YOUR_API_KEY」を独自のキーに置き換えてください。

結果はすぐに返ってきますか、それともポーリングする必要がありますか?

processing_lane=instantを指定すると、APIは同期レスポンス(HTTP 200とresult)を返します。このパラメータを指定しない場合、HTTP 202とjob_idが返され、GET /job/get/{job_id}またはWebhookを通じて結果を取得できます。

プロンプトはすべての環境で機能しますか?

プロンプトには特定のツールの指示は含まれていません。Claude、Claudeコード、およびCursorで検証されており、URLを読み取ることができる環境であればすべて対応可能です。

呼び出しの費用はいくらですか?

各応答にはcredits_billedが含まれます。パイプラインごとの Credit 価格は価格一覧表に記載されており、実際に処理された分のみが請求されます。

PaperOfficeをどこで試しますか?

PCとスマートフォンが接続されました:PCでワークスペース、電話で取得。

テスト版が準備完了しました

どこから始めますか?

フルワークスペースはPC用に最適化されています。モバイルバージョンは文書の取得、確認、共有に適しています。

app.paperoffice.ai

PCで開始する

パーソナルアクセスリンクをメールアドレスにお送りします。

無料で登録 アプリを開く PaperOfficeアプリ フル製品:ウェブ、デスクトップ、モバイル。文書の取り込み、整理、検索、チームでの作業。 無料アカウントが必要です Playgroundを開く Playground 選択した機能をすぐに試せます — 登録なし、制限付きのデモAPIキーで。 登録不要、ただし制限付きのデモAPIキー