plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "getsearchablepdf",
  "version": "1.0.3",
  "description": "Make scanned PDFs searchable with OCR.",
  "author": {
    "name": "Superdocs",
    "url": "https://getsearchablepdf.com"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "GetSearchablePDF",
        "shortDescription": "Make scans searchable with OCR",
        "longDescription": "Attach a scanned PDF or a photo of a document and GetSearchablePDF adds an OCR text layer, so you can search, select and copy its text. A panel in the chat shows progress and then a Download button for each file, up to 10 at a time. Only the pages without text go to OCR; pages that already have text are left as they are. If an old scan has a wrong text layer, run OCR anyway to replace it. Sign in with your GetSearchablePDF account to use it. Files are deleted after 60 minutes and never used for training.",
        "developerName": "Superdocs",
        "category": "Productivity",
        "capabilities": [
          "Interactive"
        ],
        "defaultPrompt": [
          "Make the attached PDF searchable.",
          "OCR this scan so I can copy its text.",
          "Turn this photo of a document into a searchable PDF."
        ],
        "websiteURL": "https://getsearchablepdf.com",
        "supportURL": "https://getsearchablepdf.com/assistants",
        "privacyPolicyURL": "https://getsearchablepdf.com/privacy",
        "termsOfServiceURL": "https://getsearchablepdf.com/terms",
        "logo": "assets/logo.png",
        "composerIcon": "assets/composer-icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Fully scanned PDF. Setup: download https://getsearchablepdf.com/samples/lease-scan-2019.pdf (3 pages, no text) and attach it. If ChatGPT asks to approve sending the file to GetSearchablePDF, approve it. The reviewer account is signed in and has pages left.",
              "prompt": "Make this PDF searchable.",
              "tools_triggered": "searchable_pdf_convert",
              "expected_behavior": "One GetSearchablePDF panel shows the file processing 3 pages, then the searchable PDF (3 pages) with a Download button. 3 pages are used from the balance. The downloaded PDF's text can be searched and copied."
            },
            {
              "description": "Mixed PDF. Setup: download https://getsearchablepdf.com/samples/annual-report-2025.pdf (40 pages, of which pages 3, 17, 18, 31, 39 and 40 are scanned) and attach it. If ChatGPT asks to approve sending the file to GetSearchablePDF, approve it. The reviewer account is signed in and has pages left.",
              "prompt": "Some pages of this report are scans. Make the whole PDF searchable.",
              "tools_triggered": "searchable_pdf_convert",
              "expected_behavior": "The panel converts the file and shows the searchable PDF (40 pages) with a Download button and the note that OCR added text to 6 of 40 pages; the others already had text. Only those 6 pages are used from the balance."
            },
            {
              "description": "Already searchable, then OCR anyway. Setup: download https://getsearchablepdf.com/samples/supply-agreement-2009.pdf (2 pages with a garbled text layer) and attach it. If ChatGPT asks to approve sending the file to GetSearchablePDF, approve it. The reviewer account is signed in and has pages left.",
              "prompt": "Make this PDF searchable. If it already has text, the text is wrong, so run OCR anyway.",
              "tools_triggered": "searchable_pdf_convert with force_ocr (or searchable_pdf_convert, then searchable_pdf_redo_with_ocr)",
              "expected_behavior": "Because the user says the existing text is wrong, ChatGPT runs OCR on both pages instead of keeping the garbled text layer. The panel shows the searchable PDF (2 pages) with a Download button, and 2 pages are used. (Without that instruction, the file is reported as already searchable, and the panel offers Run OCR anyway.)"
            },
            {
              "description": "Photo of a document. Setup: download https://getsearchablepdf.com/samples/receipt-photo.jpg and attach it. If ChatGPT asks to approve sending the file to GetSearchablePDF, approve it. The reviewer account is signed in and has pages left.",
              "prompt": "Turn this photo of a receipt into a searchable PDF.",
              "tools_triggered": "searchable_pdf_convert",
              "expected_behavior": "The photo becomes a one-page PDF with an OCR text layer. The panel shows the searchable PDF (1 page) with a Download button, and 1 page is used."
            },
            {
              "description": "Page balance. Setup: no file attached. The reviewer account is signed in and has pages left.",
              "prompt": "How many GetSearchablePDF pages do I have left?",
              "tools_triggered": "searchable_pdf_pages_left",
              "expected_behavior": "ChatGPT reports the account's remaining pages, its plan, the largest file size and page count allowed per file, and a link to a page that describes pages and plans. No file is converted, and nothing is offered for sale."
            }
          ],
          "negative": [
            {
              "description": "Summary of a PDF that already has text. Setup: attach any PDF with selectable text. GetSearchablePDF is not invoked, because nothing needs OCR; ChatGPT summarizes the file itself.",
              "prompt": "Summarize this PDF in three bullet points."
            },
            {
              "description": "Conversion to another format. Setup: attach any PDF. GetSearchablePDF is not invoked, because it only adds a text layer to PDFs; ChatGPT handles the request with other tools or explains the limitation.",
              "prompt": "Convert this PDF into a Word document."
            },
            {
              "description": "General question, no file. GetSearchablePDF is not invoked; ChatGPT answers from general knowledge.",
              "prompt": "What is OCR and how accurate is it on handwriting?"
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=VPHXZEQtKCY"
      },
      "publication": {
        "release_notes": "Initial GetSearchablePDF submission: make scanned PDFs and images searchable with OCR, convert only the pages that need it, run OCR again on wrong text layers, and download the result from the chat."
      },
      "apps": "./.app.json"
    }
  }
}