.codex-plugin/plugin.json

{
  "name": "patsol-patent-search",
  "version": "0.1.4",
  "author": {
    "name": "PatSol",
    "email": "contact@patsol.kr",
    "url": "https://patsol.kr"
  },
  "description": "Search Korean patent publications by invention description, retrieve patent details, and check account usage.",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "PatSol Patent Search",
    "developerName": "PatSol",
    "category": "Productivity",
    "capabilities": [
      "Search Korean patents",
      "Retrieve patent details",
      "Check account usage"
    ],
    "shortDescription": "Search Korean patents",
    "longDescription": "PatSol Patent Search helps inventors, researchers, and patent professionals find Korean patent publications using natural-language invention descriptions. Search by technical meaning, retrieve details for a selected patent, and check your account usage status.\n\nAvailable tools are search_patents_by_text, get_patent_detail, and get_usage_status. This release supports Korean (KR) patents only. US, JP, and mixed-country searches are not supported. Image and drawing search are not available. Search results support prior-art research; they do not establish patentability, validity, or freedom to operate.\n\nA PatSol account and OAuth authorization are required. Read-only lookups use your existing account credit balance.\n\nPatSol operates the underlying search API. Search text explicitly sent to search_patents_by_text is stored encrypted for up to 30 days for search operation, quality improvement, and support troubleshooting. The connector does not collect chat history, memory, conversation summaries, or uploaded files.\n\nSupport: contact@patsol.kr or the contact feature on patsol.kr.",
    "defaultPrompt": [
      "Find Korean patents about a battery cooling system.",
      "Find Korean patents about a foldable bicycle and show the first result in detail.",
      "Show my PatSol usage status."
    ],
    "composerIcon": "./assets/patsol-icon.png",
    "logo": "./assets/patsol-icon.png",
    "brandColor": "#164E63",
    "privacyPolicyURL": "https://wand-patsol.notion.site/privacy-protection",
    "websiteURL": "https://patsol.kr",
    "supportURL": "https://patsol.kr",
    "termsOfServiceURL": "https://wand-patsol.notion.site/terms-of-service"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Battery cooling patent search (video 02)",
              "prompt": "Find Korean patents about a battery cooling system.",
              "tools_triggered": "search_patents_by_text",
              "expected_behavior": "Search Korean patent publications and summarize actual returned matches with identifiers. Do not invent unavailable metadata."
            },
            {
              "description": "Search then retrieve details (video 03)",
              "prompt": "Find Korean patents about a foldable bicycle and show the first result in detail.",
              "tools_triggered": "search_patents_by_text, get_patent_detail",
              "expected_behavior": "Retrieve details using an identifier from actual search results. If no result is available, report it without inventing a patent."
            },
            {
              "description": "Summarize top three results by mechanism (video 04)",
              "prompt": "Find Korean patents about battery cooling and summarize the top 3 by cooling mechanism.",
              "tools_triggered": "search_patents_by_text",
              "expected_behavior": "Summarize up to three returned Korean patents by their supported cooling mechanisms; distinguish source facts from interpretation."
            },
            {
              "description": "Direct patent detail lookup (video 05)",
              "prompt": "Show details for Korean patent publication number KR1020257018921.",
              "tools_triggered": "get_patent_detail",
              "expected_behavior": "Retrieve the specified Korean publication and report available details without inventing missing fields."
            },
            {
              "description": "Account usage lookup (video 06)",
              "prompt": "Show my PatSol usage status.",
              "tools_triggered": "get_usage_status",
              "expected_behavior": "Return the authenticated account credit balance and current tool prices without exposing another account."
            }
          ],
          "negative": [
            {
              "description": "Unsupported US patents (video 07)",
              "prompt": "Find US patents about battery cooling.",
              "tools_triggered": "",
              "expected_behavior": "Explain that PatSol supports KR patents only and do not use PatSol to search US patents. Any separate web-search fallback must be clearly distinguished from PatSol results."
            },
            {
              "description": "Unsupported drawing search (video 08)",
              "prompt": "Search patents from a drawing/image.",
              "tools_triggered": "",
              "expected_behavior": "Explain that PatSol does not support direct image search. Do not invoke nonexistent image tools; offer a text-description alternative."
            },
            {
              "description": "No-result patent detail lookup (video 09)",
              "prompt": "Show details for KR00-0000-0000000 using PatSol plugin.",
              "tools_triggered": "get_patent_detail",
              "expected_behavior": "Report the returned not-found or invalid-number outcome clearly. Do not fabricate patent details or substitute another publication."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The connector provides read-only patent lookups using an existing account credit balance. The current release does not sell credits, initiate checkout, or offer paid top-ups. The operator reports a one-time initial credit allocation on first MCP OAuth consent; this is not promoted in the public listing.",
        "demo_recording_url": "https://drive.google.com/drive/folders/1i3GISNUuofhsf_mV-97wSp6Y0NaDCq7v"
      },
      "publication": {
        "release_notes": "Add review walkthrough videos and align five positive and three negative test cases with the recordings.",
        "translations": {
          "ko-KR": {
            "subtitle": "\ubc1c\uba85 \uc124\uba85\uc73c\ub85c \ud55c\uad6d \ud2b9\ud5c8 \uac80\uc0c9",
            "description": "\ubc1c\uba85 \uc124\uba85\uc73c\ub85c \ud55c\uad6d \ud2b9\ud5c8\ub97c \uac80\uc0c9\ud558\uace0, \uc120\ud0dd\ud55c \ud2b9\ud5c8\uc758 \uc0c1\uc138 \uc815\ubcf4\uc640 \uacc4\uc815 \uc0ac\uc6a9\ub7c9\uc744 \uc870\ud68c\ud569\ub2c8\ub2e4. \ubc1c\uba85\uc790\u00b7\uc5f0\uad6c\uc790\u00b7\ud2b9\ud5c8 \uc2e4\ubb34\uc790\uc758 \uc120\ud589\uae30\uc220 \uc870\uc0ac\ub97c \uc9c0\uc6d0\ud569\ub2c8\ub2e4.\n\n\ud55c\uad6d(KR) \ud2b9\ud5c8\ub9cc \uc9c0\uc6d0\ud558\uba70 \ubbf8\uad6d\u00b7\uc77c\ubcf8\u00b7\ud63c\ud569 \uad6d\uac00 \uac80\uc0c9\uacfc \ub3c4\uba74 \uac80\uc0c9\uc740 \uc81c\uacf5\ud558\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4. \uac80\uc0c9 \uacb0\uacfc\ub294 \ud2b9\ud5c8\uc131\u00b7\uc720\ud6a8\uc131\u00b7\uc2e4\uc2dc \uc790\uc720\ub97c \ud655\uc815\ud558\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4. PatSol \uacc4\uc815\uacfc OAuth \uc778\uc99d\uc774 \ud544\uc694\ud558\uba70 \uc870\ud68c\uc5d0\ub294 \uae30\uc874 \uacc4\uc815 \ud06c\ub808\ub527\uc774 \uc0ac\uc6a9\ub429\ub2c8\ub2e4.\n\n\uac80\uc0c9 \ub3c4\uad6c\uc5d0 \uc804\ub2ec\ud55c \uac80\uc0c9\ubb38\uc740 \uc11c\ube44\uc2a4 \uc6b4\uc601\u00b7\ud488\uc9c8 \uac1c\uc120\u00b7\uc9c0\uc6d0 \ubb38\uc81c \ud574\uacb0\uc744 \uc704\ud574 \uc554\ud638\ud654\ud558\uc5ec \ucd5c\ub300 30\uc77c \ubcf4\uad00\ud569\ub2c8\ub2e4. \ub300\ud654 \uc774\ub825\u00b7\uba54\ubaa8\ub9ac\u00b7\ub300\ud654 \uc694\uc57d\u00b7\uc5c5\ub85c\ub4dc \ud30c\uc77c\uc740 \uc218\uc9d1\ud558\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4."
          }
        }
      }
    }
  },
  "homepage": "https://patsol.kr",
  "apps": "./.app.json"
}