{
  "$schema": "https://isitagentready.com/schemas/ai-agents.v1.json",
  "name": "Taiwan Patent & Trademark Claims Oracle",
  "description": "High-signal Taiwan patent independent claims, legal status, annuity deadlines, and patent family oracle for autonomous AI agents.",
  "provider": "Patent Claims AI",
  "contact_email": "contact@sitetegy.com",
  "legal_info": "https://patentclaimsai.sitetegy.com/auth.md",
  "capabilities": [
    {
      "type": "retrieval",
      "description": "Query patent claims, independent limitations, legal status, and annuity deadline by Taiwan patent application number.",
      "endpoints": [
        {
          "path": "/api/patent/{app_no}",
          "method": "GET",
          "parameters": {
            "app_no": {
              "type": "string",
              "pattern": "^[0-9]{8,10}$",
              "description": "Taiwan patent application number (申請號)",
              "required": true
            }
          },
          "response_formats": ["application/json", "text/markdown"]
        }
      ]
    },
    {
      "type": "search",
      "description": "Full-text search across patent titles, applicants, IPC classification, and patent certificate numbers.",
      "endpoints": [
        {
          "path": "/api/search",
          "method": "GET",
          "parameters": {
            "q": {
              "type": "string",
              "description": "Keywords, applicant name, or IPC class code",
              "required": true
            },
            "limit": {
              "type": "integer",
              "default": 5,
              "maximum": 20
            }
          },
          "response_formats": ["application/json", "text/markdown"]
        }
      ]
    },
    {
      "type": "family",
      "description": "Retrieve multi-tier patent family networks including Priority, Division, and Twin application relationships.",
      "endpoints": [
        {
          "path": "/api/patent/{app_no}/family",
          "method": "GET",
          "parameters": {
            "app_no": {
              "type": "string",
              "description": "Taiwan patent application number",
              "required": true
            }
          },
          "response_formats": ["application/json"]
        }
      ]
    },
    {
      "type": "subscription",
      "description": "Subscribe to event-driven push alerts for patent annuity expiration and status transition to Lapsed.",
      "endpoints": [
        {
          "path": "/api/webhooks/subscribe",
          "method": "POST",
          "parameters": {
            "target_ipc": {
              "type": "string",
              "description": "IPC category code to monitor or '*' for all fields",
              "required": true
            },
            "subscriber_agent_url": {
              "type": "string",
              "description": "HTTP POST endpoint URL of the receiving AI agent",
              "required": true
            },
            "secret_key": {
              "type": "string",
              "description": "Shared secret key used to compute HMAC-SHA256 signature in X-Patent-Signature-256 header",
              "required": false
            }
          }
        }
      ]
    },
    {
      "type": "batch",
      "description": "Execute bulk patent status and annuity expiration analysis for up to 20 applications in a single roundtrip.",
      "endpoints": [
        {
          "path": "/api/batch",
          "method": "POST",
          "parameters": {
            "app_nos": {
              "type": "array",
              "items": { "type": "string" },
              "description": "List of application numbers (max 20)",
              "required": true
            }
          },
          "response_formats": ["application/json", "text/markdown"]
        }
      ]
    },
    {
      "type": "stats",
      "description": "Query overall patent database counts, active versus lapsed records, and system health status.",
      "endpoints": [
        {
          "path": "/api/stats",
          "method": "GET",
          "response_formats": ["application/json"]
        }
      ]
    }
  ],
  "agent_policy": {
    "allow_scraping": true,
    "user_agent_rules": [
      {
        "user_agent": "ParallelBot",
        "allow": true,
        "crawl_delay": 0.05
      },
      {
        "user_agent": "*",
        "allow": true
      }
    ]
  }
}