{
  "schemaVersion": "1.0",
  "item": {
    "slug": "notion-api-integration",
    "name": "Notion API Integration",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/ivangdavila/notion-api-integration",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/notion-api-integration",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/notion-api-integration",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notion-api-integration",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "blocks.md",
      "databases.md",
      "errors.md",
      "filters.md",
      "memory-template.md"
    ],
    "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-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/notion-api-integration"
    },
    "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/notion-api-integration",
    "agentPageUrl": "https://openagent3.xyz/skills/notion-api-integration/agent",
    "manifestUrl": "https://openagent3.xyz/skills/notion-api-integration/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/notion-api-integration/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": "Notion API Integration",
        "body": "Complete Notion API reference. See auxiliary files for detailed operations."
      },
      {
        "title": "Quick Start",
        "body": "curl 'https://api.notion.com/v1/users/me' \\\n  -H \"Authorization: Bearer $NOTION_API_KEY\" \\\n  -H \"Notion-Version: 2022-06-28\""
      },
      {
        "title": "Setup",
        "body": "On first use, read setup.md. Preferences stored in ~/notion-api-integration/memory.md."
      },
      {
        "title": "When to Use",
        "body": "Any Notion operation: databases, pages, blocks, users, search, comments, properties."
      },
      {
        "title": "Architecture",
        "body": "~/notion-api-integration/\n├── memory.md      # Workspace context\n└── databases.md   # Tracked database IDs"
      },
      {
        "title": "Quick Reference",
        "body": "TopicFileSetup and memorysetup.md, memory-template.mdDatabases: query, create, updatedatabases.mdPages: CRUD, propertiespages.mdBlocks: content, childrenblocks.mdProperty types referenceproperties.mdFilters and sortsfilters.mdSearch and userssearch.mdPagination patternspagination.mdError handlingerrors.md"
      },
      {
        "title": "Core Rules",
        "body": "API version header required - Always include Notion-Version: 2022-06-28 (or newer)\nBearer token auth - Authorization: Bearer $NOTION_API_KEY\nPage IDs without dashes - Remove dashes from URLs: abc123def456 not abc-123-def-456\nProperty names are case-sensitive - Match exactly as defined in database\nPagination mandatory - Use start_cursor for results over 100 items\nRate limits - 3 requests/second average, burst allowed\nIntegration access - Pages must be shared with integration to access"
      },
      {
        "title": "Authentication",
        "body": "Required environment variable:\n\nNOTION_API_KEY - Internal integration token (starts with ntn_ or secret_)\n\n# All requests require these headers\ncurl 'https://api.notion.com/v1/...' \\\n  -H \"Authorization: Bearer $NOTION_API_KEY\" \\\n  -H \"Notion-Version: 2022-06-28\" \\\n  -H \"Content-Type: application/json\""
      },
      {
        "title": "Common Traps",
        "body": "Missing Notion-Version header - 400 error\nPage ID with dashes - 404 not found\nProperty name mismatch - Silent failure or error\nSkipping pagination - Miss data beyond first 100\nNo integration access - 404 even if page exists"
      },
      {
        "title": "External Endpoints",
        "body": "EndpointPurposehttps://api.notion.com/v1/*All Notion API operations\n\nNo other endpoints are accessed."
      },
      {
        "title": "Security & Privacy",
        "body": "Environment variable used:\n\nNOTION_API_KEY - for API authentication\n\nSent to Notion: Database queries, page content, block updates via api.notion.com\nStays local: API key (in environment variable only), ~/notion-api-integration/ preferences\nNever: Store API keys in files, access pages not shared with integration"
      },
      {
        "title": "Scope",
        "body": "This skill ONLY:\n\nMakes requests to api.notion.com endpoints\nStores preferences in ~/notion-api-integration/\nProvides curl and code examples\n\nThis skill NEVER:\n\nAccesses files outside ~/notion-api-integration/\nMakes requests to other endpoints\nStores API keys in files"
      },
      {
        "title": "Trust",
        "body": "By using this skill, data is sent to Notion (notion.com).\nOnly install if you trust Notion with your workspace data."
      },
      {
        "title": "Related Skills",
        "body": "Install with clawhub install <slug> if user confirms:\n\napi — REST API patterns\npkm — Personal knowledge management\nproductivity — Task and productivity workflows"
      },
      {
        "title": "Feedback",
        "body": "If useful: clawhub star notion-api-integration\nStay updated: clawhub sync"
      }
    ],
    "body": "Notion API Integration\n\nComplete Notion API reference. See auxiliary files for detailed operations.\n\nQuick Start\ncurl 'https://api.notion.com/v1/users/me' \\\n  -H \"Authorization: Bearer $NOTION_API_KEY\" \\\n  -H \"Notion-Version: 2022-06-28\"\n\nSetup\n\nOn first use, read setup.md. Preferences stored in ~/notion-api-integration/memory.md.\n\nWhen to Use\n\nAny Notion operation: databases, pages, blocks, users, search, comments, properties.\n\nArchitecture\n~/notion-api-integration/\n├── memory.md      # Workspace context\n└── databases.md   # Tracked database IDs\n\nQuick Reference\nTopic\tFile\nSetup and memory\tsetup.md, memory-template.md\nDatabases: query, create, update\tdatabases.md\nPages: CRUD, properties\tpages.md\nBlocks: content, children\tblocks.md\nProperty types reference\tproperties.md\nFilters and sorts\tfilters.md\nSearch and users\tsearch.md\nPagination patterns\tpagination.md\nError handling\terrors.md\nCore Rules\nAPI version header required - Always include Notion-Version: 2022-06-28 (or newer)\nBearer token auth - Authorization: Bearer $NOTION_API_KEY\nPage IDs without dashes - Remove dashes from URLs: abc123def456 not abc-123-def-456\nProperty names are case-sensitive - Match exactly as defined in database\nPagination mandatory - Use start_cursor for results over 100 items\nRate limits - 3 requests/second average, burst allowed\nIntegration access - Pages must be shared with integration to access\nAuthentication\n\nRequired environment variable:\n\nNOTION_API_KEY - Internal integration token (starts with ntn_ or secret_)\n# All requests require these headers\ncurl 'https://api.notion.com/v1/...' \\\n  -H \"Authorization: Bearer $NOTION_API_KEY\" \\\n  -H \"Notion-Version: 2022-06-28\" \\\n  -H \"Content-Type: application/json\"\n\nCommon Traps\nMissing Notion-Version header - 400 error\nPage ID with dashes - 404 not found\nProperty name mismatch - Silent failure or error\nSkipping pagination - Miss data beyond first 100\nNo integration access - 404 even if page exists\nExternal Endpoints\nEndpoint\tPurpose\nhttps://api.notion.com/v1/*\tAll Notion API operations\n\nNo other endpoints are accessed.\n\nSecurity & Privacy\n\nEnvironment variable used:\n\nNOTION_API_KEY - for API authentication\n\nSent to Notion: Database queries, page content, block updates via api.notion.com Stays local: API key (in environment variable only), ~/notion-api-integration/ preferences Never: Store API keys in files, access pages not shared with integration\n\nScope\n\nThis skill ONLY:\n\nMakes requests to api.notion.com endpoints\nStores preferences in ~/notion-api-integration/\nProvides curl and code examples\n\nThis skill NEVER:\n\nAccesses files outside ~/notion-api-integration/\nMakes requests to other endpoints\nStores API keys in files\nTrust\n\nBy using this skill, data is sent to Notion (notion.com). Only install if you trust Notion with your workspace data.\n\nRelated Skills\n\nInstall with clawhub install <slug> if user confirms:\n\napi — REST API patterns\npkm — Personal knowledge management\nproductivity — Task and productivity workflows\nFeedback\nIf useful: clawhub star notion-api-integration\nStay updated: clawhub sync"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/notion-api-integration",
    "publisherUrl": "https://clawhub.ai/ivangdavila/notion-api-integration",
    "owner": "ivangdavila",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/notion-api-integration",
    "downloadUrl": "https://openagent3.xyz/downloads/notion-api-integration",
    "agentUrl": "https://openagent3.xyz/skills/notion-api-integration/agent",
    "manifestUrl": "https://openagent3.xyz/skills/notion-api-integration/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/notion-api-integration/agent.md"
  }
}