notion-search-retrieve

# Notion Search & Data Retrieval ## Overview Search across a Notion workspace, query databases with compound filters, retrieve individual pages, and extract nested block content. Covers the full read path: workspace-level search, database queries with filter/sort/pagination, page retrieval, and recursive block tree traversal. ## Prerequisites - `@notionhq/client` installed (`npm install @notionhq/client`) - Notion integration token with read access to target pages/databases - Integration added to target pages via the Share menu in Notion - Completed `notion-install-auth` setup ## Instructions ### Step 1: Search the Workspace Call `notion.search()` to find pages and databases. The integration only sees content explicitly shared with it. ```typescript import { Client } from '@notionhq/client'; const notion = new Client({ auth: process.env.NOTION_TOKEN }); // Search for pages matching a query const searchResults = await notion.search({ query: 'meeting notes', filter: { property: 'object', value: 'page', // 'page' or 'database' }, sort: { direction: 'descending', timestamp: 'last_edited_time', }, page_size: 20, }); for (const result of searchResults.results) { if (result.object === 'page' && 'properties' in result) { const titleProp = Object.values(result.properties) .find(p => p.type === 'title'); const title = titleProp?.type === 'title' ? titleProp.title.map(t => t.plain_text).join('') : 'Untitled'; ...