onenote-core-workflow-b

# OneNote — Search, Query, and Pagination ## Overview OneNote's dedicated search endpoint was deprecated in April 2024. The replacement — OData `$filter` queries on page listings — cannot search page body content, cannot search across all notebooks in a single call, and sometimes returns deleted pages in results. Pagination via `@odata.nextLink` is unreliable: the link is sometimes omitted even when more results exist. This skill provides production-tested patterns for content discovery, cross-notebook queries, and safe pagination with guard rails. Key pain points addressed: - The `$search` parameter on `/me/onenote/pages` is deprecated — use `$filter` on metadata fields only - No single endpoint searches across all notebooks — you must iterate notebooks and their sections - Deleted pages continue appearing in `GET /sections/{id}/pages` results for up to 30 minutes - `@odata.nextLink` may be absent even when `$top` items were returned (Graph bug with OneNote) ## Prerequisites - Azure app registration with delegated permissions: `Notes.Read` or `Notes.ReadWrite` - App-only auth deprecated March 31, 2025 — use delegated auth only - Python: `pip install msgraph-sdk azure-identity` - Node/TypeScript: `npm install @microsoft/microsoft-graph-client @azure/identity @azure/msal-node` - Optional for client-side search: `npm install fuse.js` or `pip install thefuzz` ## Instructions ### Step 1 — Query Pages with OData Filters OData `$filter` works on page metadata fields — not b...