{
  "schemaVersion": "1.0",
  "item": {
    "slug": "deepread-form-fill",
    "name": "DeepRead Form Fill",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/uday390/deepread-form-fill",
    "canonicalUrl": "https://clawhub.ai/uday390/deepread-form-fill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/deepread-form-fill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=deepread-form-fill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "form_fill.py",
      "package.json",
      "SKILL.md",
      "form_fill.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/deepread-form-fill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/deepread-form-fill",
    "agentPageUrl": "https://openagent3.xyz/skills/deepread-form-fill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/deepread-form-fill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/deepread-form-fill/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "DeepRead Form Fill — AI-Powered PDF Form Filling API",
        "body": "Upload any PDF form + your data as JSON. AI detects fields, maps your data, fills the form, quality-checks the result, and returns a completed PDF you can download.\n\nWorks with any PDF — scanned paper forms, government PDFs, custom templates. No AcroForm fields required."
      },
      {
        "title": "What This Skill Does",
        "body": "You provide:\n\nA blank PDF form (upload)\nYour data as JSON (e.g. {\"full_name\": \"Jane Doe\", \"dob\": \"1990-03-15\"})\n\nDeepRead returns:\n\nA filled PDF with your data placed in the correct fields\nA quality report showing what was filled, what was verified, and what needs human review\n\nNo field mapping, no coordinates, no configuration. The AI figures out where everything goes."
      },
      {
        "title": "Get Your API Key",
        "body": "# Sign up (free — 2,000 pages/month, no credit card)\n# https://www.deepread.tech/dashboard/?utm_source=clawdhub\n\nSave your API key:\n\nexport DEEPREAD_API_KEY=\"sk_live_your_key_here\""
      },
      {
        "title": "Fill a Form (3 lines)",
        "body": "# 1. Submit form + data\ncurl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@application.pdf\" \\\n  -F 'form_fields={\"full_name\": \"Jane Doe\", \"date_of_birth\": \"03/15/1990\", \"address\": \"123 Main St, Portland OR 97201\"}'\n\n# Response (immediate):\n# {\"id\": \"<job_id>\", \"status\": \"queued\"}\n\n# 2. Poll for result (use the id from step 1)\ncurl https://api.deepread.tech/v1/form-fill/<job_id> \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\"\n\n# 3. Download the filled PDF from filled_form_url in the response"
      },
      {
        "title": "POST /v1/form-fill — Submit a Form for Filling",
        "body": "Authentication: X-API-Key header (required)\n\nContent-Type: multipart/form-data\n\nParameters:\n\nFieldTypeRequiredDescriptionfileFileYesPDF form to fillform_fieldsJSON stringYes{\"field_name\": \"value\"} — your datawebhook_urlStringNoURL to receive results when doneidempotency_keyStringNoPrevent duplicate submissionsurl_expires_inIntegerNoSigned URL expiry in seconds (default: 604800 = 7 days, min: 3600, max: 604800)\n\nExample:\n\ncurl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@tax_form.pdf\" \\\n  -F 'form_fields={\n    \"taxpayer_name\": \"Jane Doe\",\n    \"ssn\": \"123-45-6789\",\n    \"filing_status\": \"Single\",\n    \"total_income\": \"85000\",\n    \"tax_year\": \"2025\"\n  }' \\\n  -F \"webhook_url=https://your-app.com/webhooks/form-fill\"\n\nResponse (immediate):\n\n{\n  \"id\": \"<job_id>\",\n  \"status\": \"queued\"\n}\n\nProcessing is asynchronous — poll the GET endpoint or use a webhook."
      },
      {
        "title": "GET /v1/form-fill/{job_id} — Get Job Status & Results",
        "body": "Authentication: X-API-Key header (required)\n\nRate limit: 20 requests per 60 seconds\n\ncurl https://api.deepread.tech/v1/form-fill/<job_id> \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\"\n\nResponse when completed:\n\n{\n  \"id\": \"<job_id>\",\n  \"status\": \"completed\",\n  \"file_name\": \"tax_form.pdf\",\n  \"created_at\": \"2025-06-15T10:00:00Z\",\n  \"completed_at\": \"2025-06-15T10:00:18Z\",\n  \"filled_form_url\": \"https://storage.deepread.tech/form_fill/.../filled.pdf\",\n  \"fields_detected\": 25,\n  \"fields_filled\": 23,\n  \"fields_verified\": 21,\n  \"fields_hil_flagged\": 2,\n  \"duration_seconds\": 18.3,\n  \"report\": {\n    \"summary\": {\n      \"fields_detected\": 25,\n      \"fields_filled\": 23,\n      \"fields_verified\": 21,\n      \"fields_hil_flagged\": 2,\n      \"mappings_created\": 23,\n      \"unmapped_keys\": 0,\n      \"adjustments_made\": 3\n    },\n    \"fields\": [\n      {\n        \"field_index\": 0,\n        \"label\": \"Taxpayer Name\",\n        \"field_type\": \"text\",\n        \"page\": 1,\n        \"value\": \"Jane Doe\",\n        \"hil_flag\": false,\n        \"verified\": true\n      },\n      {\n        \"field_index\": 8,\n        \"label\": \"Total Income\",\n        \"field_type\": \"text\",\n        \"page\": 2,\n        \"value\": \"85000\",\n        \"hil_flag\": true,\n        \"verified\": false,\n        \"reason\": \"Text overlaps adjacent field\"\n      }\n    ],\n    \"mappings\": [\n      {\n        \"user_key\": \"taxpayer_name\",\n        \"field_index\": 0,\n        \"value_to_fill\": \"Jane Doe\",\n        \"confidence\": 0.95\n      }\n    ],\n    \"unmapped_user_keys\": [],\n    \"adjustments_made\": [\"Field 8: reduced font size from 12pt to 8pt\"],\n    \"qa_feedback\": [\"Total Income: text overlaps adjacent field\"],\n    \"errors\": []\n  },\n  \"errors\": null,\n  \"error_message\": null\n}\n\nStatus values:\n\nStatusMeaningqueuedWaiting for processingprocessingAI is filling the formcompletedDone — download from filled_form_urlfailedSomething went wrong — check error_message\n\nPoll every 5-10 seconds until status is completed or failed."
      },
      {
        "title": "Webhook Notification (Optional)",
        "body": "If you provide webhook_url, DeepRead POSTs results when the job finishes:\n\nCompleted:\n\n{\n  \"job_id\": \"<job_id>\",\n  \"status\": \"completed\",\n  \"created_at\": \"<ISO 8601 timestamp>\",\n  \"completed_at\": \"<ISO 8601 timestamp>\",\n  \"result\": {\n    \"filled_form_url\": \"<signed URL to download filled PDF>\",\n    \"fields_detected\": 25,\n    \"fields_filled\": 23,\n    \"fields_verified\": 21,\n    \"fields_hil_flagged\": 2,\n    \"report\": { ... }\n  }\n}\n\nFailed:\n\n{\n  \"job_id\": \"<job_id>\",\n  \"status\": \"failed\",\n  \"created_at\": \"<ISO 8601 timestamp>\",\n  \"completed_at\": \"<ISO 8601 timestamp>\",\n  \"error\": \"Form fill timed out after 600s\",\n  \"errors\": [\"Form fill timed out after 600s\"]\n}"
      },
      {
        "title": "How It Works (Under the Hood)",
        "body": "Upload PDF + JSON data\n       │\n       ▼\n┌──────────────────────┐\n│ 1. DETECT FIELDS     │  Vision AI scans every page, finds all fillable areas\n│    (visual, not PDF   │  Returns: label, type, page, bounding box coordinates\n│     form fields)      │\n└──────────┬───────────┘\n           ▼\n┌──────────────────────┐\n│ 2. MAP DATA          │  AI semantically matches your JSON keys → form fields\n│    \"full_name\" →     │  Transforms values: splits names, formats dates,\n│    \"Full Name\" field  │  converts checkboxes, adds currency symbols\n└──────────┬───────────┘\n           ▼\n┌──────────────────────┐\n│ 3. FILL FORM         │  Places text at visual coordinates on the PDF\n│    coordinate-based   │  Handles: text, checkboxes, dropdowns\n│    insertion          │\n└──────────┬───────────┘\n           ▼\n┌──────────────────────┐\n│ 4. QA CHECK          │  Vision AI re-reads the filled form to verify:\n│    visual verify      │  - Text is readable, not cut off\n│                       │  - Positioned correctly, no overlaps\n└──────────┬───────────┘\n           ▼\n┌──────────────────────┐\n│ 5. REPAIR (if needed)│  Auto-fixes: shrink font, adjust position, remap\n│    per-field fixes    │  If repair fails → flag for human review (hil_flag)\n└──────────┬───────────┘\n           ▼\n      Filled PDF + Report\n\nKey insight: This is visual coordinate-based filling, not AcroForm-based. It works on any PDF — scanned paper forms, government PDFs with no editable fields, custom templates."
      },
      {
        "title": "Loan Application",
        "body": "curl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@loan_application.pdf\" \\\n  -F 'form_fields={\n    \"applicant_name\": \"Jane Doe\",\n    \"date_of_birth\": \"03/15/1990\",\n    \"ssn\": \"123-45-6789\",\n    \"employer\": \"Acme Corp\",\n    \"annual_income\": \"95000\",\n    \"loan_amount\": \"350000\",\n    \"property_address\": \"456 Oak Ave, Portland OR 97201\",\n    \"loan_type\": \"30-Year Fixed\"\n  }'"
      },
      {
        "title": "Insurance Claim",
        "body": "curl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@claim_form.pdf\" \\\n  -F 'form_fields={\n    \"policy_number\": \"INS-2025-78901\",\n    \"insured_name\": \"Jane Doe\",\n    \"date_of_loss\": \"06/01/2025\",\n    \"description\": \"Water damage to basement from pipe burst\",\n    \"estimated_damage\": \"12500\",\n    \"photos_attached\": \"true\"\n  }'"
      },
      {
        "title": "Government Form (W-4, I-9, etc.)",
        "body": "curl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@w4_form.pdf\" \\\n  -F 'form_fields={\n    \"first_name\": \"Jane\",\n    \"last_name\": \"Doe\",\n    \"ssn\": \"123-45-6789\",\n    \"address\": \"123 Main St\",\n    \"city\": \"Portland\",\n    \"state\": \"OR\",\n    \"zip\": \"97201\",\n    \"filing_status\": \"Single\",\n    \"multiple_jobs\": \"false\"\n  }'"
      },
      {
        "title": "Batch Processing (Same Template, Different Data)",
        "body": "import json\nimport os\nimport requests\nimport time\n\nAPI_KEY = os.environ[\"DEEPREAD_API_KEY\"]\nFORM_TEMPLATE = \"application.pdf\"\n\napplicants = [\n    {\"full_name\": \"Jane Doe\", \"email\": \"jane@example.com\", \"dob\": \"1990-03-15\"},\n    {\"full_name\": \"John Smith\", \"email\": \"john@example.com\", \"dob\": \"1985-07-22\"},\n    {\"full_name\": \"Alice Chen\", \"email\": \"alice@example.com\", \"dob\": \"1992-11-08\"},\n]\n\njobs = []\nfor i, applicant in enumerate(applicants):\n    with open(FORM_TEMPLATE, \"rb\") as f:\n        resp = requests.post(\n            \"https://api.deepread.tech/v1/form-fill\",\n            headers={\"X-API-Key\": API_KEY},\n            files={\"file\": (FORM_TEMPLATE, f, \"application/pdf\")},\n            data={\n                \"form_fields\": json.dumps(applicant),\n                \"idempotency_key\": f\"batch-2025-06-{i}\",\n            },\n        )\n    job_id = resp.json()[\"id\"]\n    jobs.append(job_id)\n    print(f\"Submitted: {applicant['full_name']} → job {job_id}\")\n\n# Poll for results\nfor job_id in jobs:\n    while True:\n        result = requests.get(\n            f\"https://api.deepread.tech/v1/form-fill/{job_id}\",\n            headers={\"X-API-Key\": API_KEY},\n        ).json()\n        if result[\"status\"] in (\"completed\", \"failed\"):\n            print(f\"Job {job_id}: {result['status']}\")\n            if result[\"status\"] == \"completed\":\n                print(f\"  Download: {result['filled_form_url']}\")\n                print(f\"  Fields: {result['fields_filled']}/{result['fields_detected']} filled, \"\n                      f\"{result['fields_hil_flagged']} need review\")\n            break\n        time.sleep(5)"
      },
      {
        "title": "fields_detected vs fields_filled vs fields_verified",
        "body": "MetricWhat it meansfields_detectedTotal form fields AI found on the PDFfields_filledFields where your data was placedfields_verifiedFields that passed visual QA (text readable, positioned correctly)fields_hil_flaggedFields needing human review (AI couldn't fully verify)\n\nTypical result: 90-95% of fields verified, 2-5% flagged for review."
      },
      {
        "title": "HIL Flags (Human-in-the-Loop)",
        "body": "A field gets hil_flag: true when:\n\nText overlaps an adjacent field\nFont had to be shrunk significantly\nValue doesn't visually match field expectations\nRepair attempts didn't fully resolve the issue\n\nEach flagged field includes a reason explaining why review is needed."
      },
      {
        "title": "Unmapped Keys",
        "body": "If your JSON has keys that don't match any form field, they appear in unmapped_user_keys. This means:\n\nThe form doesn't have a matching field\nOr the field label is ambiguous"
      },
      {
        "title": "Idempotency",
        "body": "Prevent duplicate submissions with idempotency_key:\n\n# First request\ncurl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@form.pdf\" \\\n  -F 'form_fields={\"name\": \"Jane\"}' \\\n  -F \"idempotency_key=submission-abc-123\"\n# → {\"id\": \"<job_id>\", \"status\": \"queued\"}\n\n# Retry (same key) — returns the same job, no duplicate\ncurl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@form.pdf\" \\\n  -F 'form_fields={\"name\": \"Jane\"}' \\\n  -F \"idempotency_key=submission-abc-123\"\n# → {\"id\": \"<same job_id as above>\", \"status\": \"queued\"}  ← SAME JOB"
      },
      {
        "title": "Use DeepRead Form Fill For:",
        "body": "Loan/mortgage applications — fill 20+ page forms from CRM data\nInsurance claims — populate claim forms automatically\nGovernment forms — W-4, I-9, tax forms, permits, benefits applications\nLegal documents — contracts, agreements with field placeholders\nOnboarding packets — new hire paperwork from HR systems\nBatch processing — same template, hundreds of applicants"
      },
      {
        "title": "Don't Use For:",
        "body": "Creating PDFs from scratch — this fills existing forms, doesn't generate new ones\nReal-time (<1 second) — processing takes 15-30 seconds (async)\nNon-PDF formats — PDF only (DOCX support coming soon)"
      },
      {
        "title": "Free Tier (No Credit Card)",
        "body": "2,000 pages/month\nFull feature access"
      },
      {
        "title": "Paid Plans",
        "body": "PRO: 50,000 pages/month @ $99/mo\nSCALE: Custom volume pricing\n\nUpgrade: https://www.deepread.tech/dashboard/billing?utm_source=clawdhub"
      },
      {
        "title": "Error: 400 \"Only PDF files are supported\"",
        "body": "Upload a .pdf file. Other formats are not yet supported."
      },
      {
        "title": "Error: 400 \"Invalid JSON in form_fields\"",
        "body": "Check your JSON syntax. Must be a valid JSON object (not array):\n\n✅ {\"name\": \"Jane Doe\", \"dob\": \"1990-03-15\"}\n❌ [\"name\", \"dob\"]\n❌ \"just a string\""
      },
      {
        "title": "Error: 429 \"Monthly page quota exceeded\"",
        "body": "Upgrade to PRO or wait until next billing cycle."
      },
      {
        "title": "Status: \"failed\" with \"Vision model timeout\"",
        "body": "The form is very complex or has many pages. Try splitting into smaller sections."
      },
      {
        "title": "Fields not mapped correctly",
        "body": "Add more descriptive keys in your JSON. The AI uses your key names to match fields:\n\n✅ {\"applicant_full_name\": \"Jane Doe\"}  — clear, matches form labels\n❌ {\"field1\": \"Jane Doe\"}  — ambiguous, hard to map"
      },
      {
        "title": "Some fields flagged for review",
        "body": "This is expected for 2-5% of fields. Check report.fields for the reason on each flagged field."
      },
      {
        "title": "Endpoints Used",
        "body": "EndpointMethodAuthPurposehttps://api.deepread.tech/v1/form-fillPOSTAPI KeySubmit form + datahttps://api.deepread.tech/v1/form-fill/{job_id}GETAPI KeyPoll for status + results"
      },
      {
        "title": "Support",
        "body": "Dashboard: https://www.deepread.tech/dashboard\nIssues: https://github.com/deepread-tech/deep-read-service/issues\nEmail: hello@deepread.tech\n\nGet started free: https://www.deepread.tech/dashboard/?utm_source=clawdhub"
      }
    ],
    "body": "DeepRead Form Fill — AI-Powered PDF Form Filling API\n\nUpload any PDF form + your data as JSON. AI detects fields, maps your data, fills the form, quality-checks the result, and returns a completed PDF you can download.\n\nWorks with any PDF — scanned paper forms, government PDFs, custom templates. No AcroForm fields required.\n\nWhat This Skill Does\n\nYou provide:\n\nA blank PDF form (upload)\nYour data as JSON (e.g. {\"full_name\": \"Jane Doe\", \"dob\": \"1990-03-15\"})\n\nDeepRead returns:\n\nA filled PDF with your data placed in the correct fields\nA quality report showing what was filled, what was verified, and what needs human review\n\nNo field mapping, no coordinates, no configuration. The AI figures out where everything goes.\n\nSetup\nGet Your API Key\n# Sign up (free — 2,000 pages/month, no credit card)\n# https://www.deepread.tech/dashboard/?utm_source=clawdhub\n\n\nSave your API key:\n\nexport DEEPREAD_API_KEY=\"sk_live_your_key_here\"\n\nQuick Start\nFill a Form (3 lines)\n# 1. Submit form + data\ncurl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@application.pdf\" \\\n  -F 'form_fields={\"full_name\": \"Jane Doe\", \"date_of_birth\": \"03/15/1990\", \"address\": \"123 Main St, Portland OR 97201\"}'\n\n# Response (immediate):\n# {\"id\": \"<job_id>\", \"status\": \"queued\"}\n\n# 2. Poll for result (use the id from step 1)\ncurl https://api.deepread.tech/v1/form-fill/<job_id> \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\"\n\n# 3. Download the filled PDF from filled_form_url in the response\n\nAPI Reference\nPOST /v1/form-fill — Submit a Form for Filling\n\nAuthentication: X-API-Key header (required)\n\nContent-Type: multipart/form-data\n\nParameters:\n\nField\tType\tRequired\tDescription\nfile\tFile\tYes\tPDF form to fill\nform_fields\tJSON string\tYes\t{\"field_name\": \"value\"} — your data\nwebhook_url\tString\tNo\tURL to receive results when done\nidempotency_key\tString\tNo\tPrevent duplicate submissions\nurl_expires_in\tInteger\tNo\tSigned URL expiry in seconds (default: 604800 = 7 days, min: 3600, max: 604800)\n\nExample:\n\ncurl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@tax_form.pdf\" \\\n  -F 'form_fields={\n    \"taxpayer_name\": \"Jane Doe\",\n    \"ssn\": \"123-45-6789\",\n    \"filing_status\": \"Single\",\n    \"total_income\": \"85000\",\n    \"tax_year\": \"2025\"\n  }' \\\n  -F \"webhook_url=https://your-app.com/webhooks/form-fill\"\n\n\nResponse (immediate):\n\n{\n  \"id\": \"<job_id>\",\n  \"status\": \"queued\"\n}\n\n\nProcessing is asynchronous — poll the GET endpoint or use a webhook.\n\nGET /v1/form-fill/{job_id} — Get Job Status & Results\n\nAuthentication: X-API-Key header (required)\n\nRate limit: 20 requests per 60 seconds\n\ncurl https://api.deepread.tech/v1/form-fill/<job_id> \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\"\n\n\nResponse when completed:\n\n{\n  \"id\": \"<job_id>\",\n  \"status\": \"completed\",\n  \"file_name\": \"tax_form.pdf\",\n  \"created_at\": \"2025-06-15T10:00:00Z\",\n  \"completed_at\": \"2025-06-15T10:00:18Z\",\n  \"filled_form_url\": \"https://storage.deepread.tech/form_fill/.../filled.pdf\",\n  \"fields_detected\": 25,\n  \"fields_filled\": 23,\n  \"fields_verified\": 21,\n  \"fields_hil_flagged\": 2,\n  \"duration_seconds\": 18.3,\n  \"report\": {\n    \"summary\": {\n      \"fields_detected\": 25,\n      \"fields_filled\": 23,\n      \"fields_verified\": 21,\n      \"fields_hil_flagged\": 2,\n      \"mappings_created\": 23,\n      \"unmapped_keys\": 0,\n      \"adjustments_made\": 3\n    },\n    \"fields\": [\n      {\n        \"field_index\": 0,\n        \"label\": \"Taxpayer Name\",\n        \"field_type\": \"text\",\n        \"page\": 1,\n        \"value\": \"Jane Doe\",\n        \"hil_flag\": false,\n        \"verified\": true\n      },\n      {\n        \"field_index\": 8,\n        \"label\": \"Total Income\",\n        \"field_type\": \"text\",\n        \"page\": 2,\n        \"value\": \"85000\",\n        \"hil_flag\": true,\n        \"verified\": false,\n        \"reason\": \"Text overlaps adjacent field\"\n      }\n    ],\n    \"mappings\": [\n      {\n        \"user_key\": \"taxpayer_name\",\n        \"field_index\": 0,\n        \"value_to_fill\": \"Jane Doe\",\n        \"confidence\": 0.95\n      }\n    ],\n    \"unmapped_user_keys\": [],\n    \"adjustments_made\": [\"Field 8: reduced font size from 12pt to 8pt\"],\n    \"qa_feedback\": [\"Total Income: text overlaps adjacent field\"],\n    \"errors\": []\n  },\n  \"errors\": null,\n  \"error_message\": null\n}\n\n\nStatus values:\n\nStatus\tMeaning\nqueued\tWaiting for processing\nprocessing\tAI is filling the form\ncompleted\tDone — download from filled_form_url\nfailed\tSomething went wrong — check error_message\n\nPoll every 5-10 seconds until status is completed or failed.\n\nWebhook Notification (Optional)\n\nIf you provide webhook_url, DeepRead POSTs results when the job finishes:\n\nCompleted:\n\n{\n  \"job_id\": \"<job_id>\",\n  \"status\": \"completed\",\n  \"created_at\": \"<ISO 8601 timestamp>\",\n  \"completed_at\": \"<ISO 8601 timestamp>\",\n  \"result\": {\n    \"filled_form_url\": \"<signed URL to download filled PDF>\",\n    \"fields_detected\": 25,\n    \"fields_filled\": 23,\n    \"fields_verified\": 21,\n    \"fields_hil_flagged\": 2,\n    \"report\": { ... }\n  }\n}\n\n\nFailed:\n\n{\n  \"job_id\": \"<job_id>\",\n  \"status\": \"failed\",\n  \"created_at\": \"<ISO 8601 timestamp>\",\n  \"completed_at\": \"<ISO 8601 timestamp>\",\n  \"error\": \"Form fill timed out after 600s\",\n  \"errors\": [\"Form fill timed out after 600s\"]\n}\n\nHow It Works (Under the Hood)\nUpload PDF + JSON data\n       │\n       ▼\n┌──────────────────────┐\n│ 1. DETECT FIELDS     │  Vision AI scans every page, finds all fillable areas\n│    (visual, not PDF   │  Returns: label, type, page, bounding box coordinates\n│     form fields)      │\n└──────────┬───────────┘\n           ▼\n┌──────────────────────┐\n│ 2. MAP DATA          │  AI semantically matches your JSON keys → form fields\n│    \"full_name\" →     │  Transforms values: splits names, formats dates,\n│    \"Full Name\" field  │  converts checkboxes, adds currency symbols\n└──────────┬───────────┘\n           ▼\n┌──────────────────────┐\n│ 3. FILL FORM         │  Places text at visual coordinates on the PDF\n│    coordinate-based   │  Handles: text, checkboxes, dropdowns\n│    insertion          │\n└──────────┬───────────┘\n           ▼\n┌──────────────────────┐\n│ 4. QA CHECK          │  Vision AI re-reads the filled form to verify:\n│    visual verify      │  - Text is readable, not cut off\n│                       │  - Positioned correctly, no overlaps\n└──────────┬───────────┘\n           ▼\n┌──────────────────────┐\n│ 5. REPAIR (if needed)│  Auto-fixes: shrink font, adjust position, remap\n│    per-field fixes    │  If repair fails → flag for human review (hil_flag)\n└──────────┬───────────┘\n           ▼\n      Filled PDF + Report\n\n\nKey insight: This is visual coordinate-based filling, not AcroForm-based. It works on any PDF — scanned paper forms, government PDFs with no editable fields, custom templates.\n\nUsage Examples\nLoan Application\ncurl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@loan_application.pdf\" \\\n  -F 'form_fields={\n    \"applicant_name\": \"Jane Doe\",\n    \"date_of_birth\": \"03/15/1990\",\n    \"ssn\": \"123-45-6789\",\n    \"employer\": \"Acme Corp\",\n    \"annual_income\": \"95000\",\n    \"loan_amount\": \"350000\",\n    \"property_address\": \"456 Oak Ave, Portland OR 97201\",\n    \"loan_type\": \"30-Year Fixed\"\n  }'\n\nInsurance Claim\ncurl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@claim_form.pdf\" \\\n  -F 'form_fields={\n    \"policy_number\": \"INS-2025-78901\",\n    \"insured_name\": \"Jane Doe\",\n    \"date_of_loss\": \"06/01/2025\",\n    \"description\": \"Water damage to basement from pipe burst\",\n    \"estimated_damage\": \"12500\",\n    \"photos_attached\": \"true\"\n  }'\n\nGovernment Form (W-4, I-9, etc.)\ncurl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@w4_form.pdf\" \\\n  -F 'form_fields={\n    \"first_name\": \"Jane\",\n    \"last_name\": \"Doe\",\n    \"ssn\": \"123-45-6789\",\n    \"address\": \"123 Main St\",\n    \"city\": \"Portland\",\n    \"state\": \"OR\",\n    \"zip\": \"97201\",\n    \"filing_status\": \"Single\",\n    \"multiple_jobs\": \"false\"\n  }'\n\nBatch Processing (Same Template, Different Data)\nimport json\nimport os\nimport requests\nimport time\n\nAPI_KEY = os.environ[\"DEEPREAD_API_KEY\"]\nFORM_TEMPLATE = \"application.pdf\"\n\napplicants = [\n    {\"full_name\": \"Jane Doe\", \"email\": \"jane@example.com\", \"dob\": \"1990-03-15\"},\n    {\"full_name\": \"John Smith\", \"email\": \"john@example.com\", \"dob\": \"1985-07-22\"},\n    {\"full_name\": \"Alice Chen\", \"email\": \"alice@example.com\", \"dob\": \"1992-11-08\"},\n]\n\njobs = []\nfor i, applicant in enumerate(applicants):\n    with open(FORM_TEMPLATE, \"rb\") as f:\n        resp = requests.post(\n            \"https://api.deepread.tech/v1/form-fill\",\n            headers={\"X-API-Key\": API_KEY},\n            files={\"file\": (FORM_TEMPLATE, f, \"application/pdf\")},\n            data={\n                \"form_fields\": json.dumps(applicant),\n                \"idempotency_key\": f\"batch-2025-06-{i}\",\n            },\n        )\n    job_id = resp.json()[\"id\"]\n    jobs.append(job_id)\n    print(f\"Submitted: {applicant['full_name']} → job {job_id}\")\n\n# Poll for results\nfor job_id in jobs:\n    while True:\n        result = requests.get(\n            f\"https://api.deepread.tech/v1/form-fill/{job_id}\",\n            headers={\"X-API-Key\": API_KEY},\n        ).json()\n        if result[\"status\"] in (\"completed\", \"failed\"):\n            print(f\"Job {job_id}: {result['status']}\")\n            if result[\"status\"] == \"completed\":\n                print(f\"  Download: {result['filled_form_url']}\")\n                print(f\"  Fields: {result['fields_filled']}/{result['fields_detected']} filled, \"\n                      f\"{result['fields_hil_flagged']} need review\")\n            break\n        time.sleep(5)\n\nUnderstanding the Report\nfields_detected vs fields_filled vs fields_verified\nMetric\tWhat it means\nfields_detected\tTotal form fields AI found on the PDF\nfields_filled\tFields where your data was placed\nfields_verified\tFields that passed visual QA (text readable, positioned correctly)\nfields_hil_flagged\tFields needing human review (AI couldn't fully verify)\n\nTypical result: 90-95% of fields verified, 2-5% flagged for review.\n\nHIL Flags (Human-in-the-Loop)\n\nA field gets hil_flag: true when:\n\nText overlaps an adjacent field\nFont had to be shrunk significantly\nValue doesn't visually match field expectations\nRepair attempts didn't fully resolve the issue\n\nEach flagged field includes a reason explaining why review is needed.\n\nUnmapped Keys\n\nIf your JSON has keys that don't match any form field, they appear in unmapped_user_keys. This means:\n\nThe form doesn't have a matching field\nOr the field label is ambiguous\nIdempotency\n\nPrevent duplicate submissions with idempotency_key:\n\n# First request\ncurl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@form.pdf\" \\\n  -F 'form_fields={\"name\": \"Jane\"}' \\\n  -F \"idempotency_key=submission-abc-123\"\n# → {\"id\": \"<job_id>\", \"status\": \"queued\"}\n\n# Retry (same key) — returns the same job, no duplicate\ncurl -X POST https://api.deepread.tech/v1/form-fill \\\n  -H \"X-API-Key: $DEEPREAD_API_KEY\" \\\n  -F \"file=@form.pdf\" \\\n  -F 'form_fields={\"name\": \"Jane\"}' \\\n  -F \"idempotency_key=submission-abc-123\"\n# → {\"id\": \"<same job_id as above>\", \"status\": \"queued\"}  ← SAME JOB\n\nWhen to Use This Skill\nUse DeepRead Form Fill For:\nLoan/mortgage applications — fill 20+ page forms from CRM data\nInsurance claims — populate claim forms automatically\nGovernment forms — W-4, I-9, tax forms, permits, benefits applications\nLegal documents — contracts, agreements with field placeholders\nOnboarding packets — new hire paperwork from HR systems\nBatch processing — same template, hundreds of applicants\nDon't Use For:\nCreating PDFs from scratch — this fills existing forms, doesn't generate new ones\nReal-time (<1 second) — processing takes 15-30 seconds (async)\nNon-PDF formats — PDF only (DOCX support coming soon)\nRate Limits & Pricing\nFree Tier (No Credit Card)\n2,000 pages/month\nFull feature access\nPaid Plans\nPRO: 50,000 pages/month @ $99/mo\nSCALE: Custom volume pricing\n\nUpgrade: https://www.deepread.tech/dashboard/billing?utm_source=clawdhub\n\nTroubleshooting\nError: 400 \"Only PDF files are supported\"\n\nUpload a .pdf file. Other formats are not yet supported.\n\nError: 400 \"Invalid JSON in form_fields\"\n\nCheck your JSON syntax. Must be a valid JSON object (not array):\n\n✅ {\"name\": \"Jane Doe\", \"dob\": \"1990-03-15\"}\n❌ [\"name\", \"dob\"]\n❌ \"just a string\"\n\nError: 429 \"Monthly page quota exceeded\"\n\nUpgrade to PRO or wait until next billing cycle.\n\nStatus: \"failed\" with \"Vision model timeout\"\n\nThe form is very complex or has many pages. Try splitting into smaller sections.\n\nFields not mapped correctly\n\nAdd more descriptive keys in your JSON. The AI uses your key names to match fields:\n\n✅ {\"applicant_full_name\": \"Jane Doe\"}  — clear, matches form labels\n❌ {\"field1\": \"Jane Doe\"}  — ambiguous, hard to map\n\nSome fields flagged for review\n\nThis is expected for 2-5% of fields. Check report.fields for the reason on each flagged field.\n\nEndpoints Used\nEndpoint\tMethod\tAuth\tPurpose\nhttps://api.deepread.tech/v1/form-fill\tPOST\tAPI Key\tSubmit form + data\nhttps://api.deepread.tech/v1/form-fill/{job_id}\tGET\tAPI Key\tPoll for status + results\nSupport\nDashboard: https://www.deepread.tech/dashboard\nIssues: https://github.com/deepread-tech/deep-read-service/issues\nEmail: hello@deepread.tech\n\nGet started free: https://www.deepread.tech/dashboard/?utm_source=clawdhub"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/uday390/deepread-form-fill",
    "publisherUrl": "https://clawhub.ai/uday390/deepread-form-fill",
    "owner": "uday390",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/deepread-form-fill",
    "downloadUrl": "https://openagent3.xyz/downloads/deepread-form-fill",
    "agentUrl": "https://openagent3.xyz/skills/deepread-form-fill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/deepread-form-fill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/deepread-form-fill/agent.md"
  }
}