Notion

• AI 에이전트가 회의 노트, 작업 항목 또는 보고서 생성 등 Notion 페이지를 자동으로 생성하거나 업데이트하길 원합니다.
• 필터와 정렬을 사용하여 Notion 데이터베이스를 쿼리하고 구조화된 레코드(예: 활성 작업, CRM 항목, 프로젝트 트래커)를 검색해야 합니다.
• 기존 페이지에 콘텐츠 블록(단락, 목록 등)을 프로그래밍 방식으로 추가하길 원합니다.
• 자동화된 워크플로우의 일환으로 Notion 페이지 내에 새 데이터베이스(데이터 소스)를 생성해야 합니다.

• 데이터베이스 뷰 필터를 설정하거나 수정해야 하는 경우 — 이는 UI 전용이며 API를 통해 변경할 수 없습니다.
• 매우 높은 처리량의 작업이 필요한 경우 — Notion API 속도 제한은 초당 약 3개 요청으로, 대량 작업의 병목 현상이 될 수 있습니다.
• 대상 페이지 또는 데이터베이스가 Notion 통합과 공유되지 않은 경우 — Notion UI에서 수동으로 액세스 권한을 부여해야 합니다.

페이지 메타데이터와 콘텐츠를 가져오고, 데이터베이스 내부 또는 다른 페이지의 하위 항목으로 새 페이지를 생성하며, PATCH를 통해 페이지 속성을 업데이트합니다. 제목, 리치 텍스트, 선택, 날짜, 체크박스, URL, 관계 등 모든 일반적인 속성 유형을 지원합니다.

API 버전 2025-09-03에서 도입된 /data_sources/{id}/query 엔드포인트를 통해 필터와 정렬 순서를 사용하여 Notion 데이터베이스를 쿼리합니다. 상태, 날짜 또는 선택 필드와 같은 속성 값으로 필터링하고 페이지네이션된 결과를 가져옵니다.

단락 및 기타 블록 유형을 포함한 다양한 콘텐츠 블록을 모든 페이지에 직접 추가하세요. 페이지의 전체 블록 트리를 가져와 콘텐츠 구조를 확인할 수 있습니다.

기존 페이지의 하위 항목으로 새로운 구조화된 데이터베이스(데이터 소스)를 생성하며, 제목, 선택 항목, 날짜 등을 포함한 커스텀 속성 스키마를 설정할 수 있습니다. is_inline: true를 사용하면 페이지 내에 인라인으로 삽입할 수 있습니다.

/search 엔드포인트를 사용하여 통합에서 접근 가능한 모든 페이지와 데이터베이스를 검색합니다. 결과에는 페이지와 데이터 소스가 모두 포함되며, 각각의 객체 유형과 ID로 식별됩니다.

이 스킬은 Notion API 버전 2025-09-03을 대상으로 하며, 이 버전에서는 데이터 소스 명명 규칙이 도입되었습니다. 이중 ID 시스템(database_id 대 data_source_id)과 각각을 언제 사용해야 하는지에 대한 자세한 안내가 제공됩니다.

에이전트는 Notion 프로젝트 데이터베이스에서 특정 상태(예: "활성")의 항목을 조회하고, 작업이 진행됨에 따라 속성을 업데이트하며, 새로운 작업 항목을 생성할 수 있습니다. 이를 통해 Notion 워크스페이스를 외부 이벤트나 에이전트의 결정과 동기화된 상태로 유지할 수 있습니다.

보고서, 요약 또는 브리핑을 생성한 후, 에이전트는 새로운 Notion 페이지를 만들고 콘텐츠를 구조화된 블록으로 추가할 수 있습니다. 이를 통해 AI 출력물을 팀의 지식 베이스에서 즉시 활용할 수 있습니다.

리드, 연락처 또는 데이터 포인트가 수집될 때 구조화된 속성(이름, 상태, 날짜, URL)과 함께 Notion 데이터베이스에 새 레코드를 자동으로 추가하여 수동 데이터 입력을 대체합니다.

에이전트는 제목 키워드를 기반으로 Notion 워크스페이스에서 관련 페이지나 데이터베이스를 검색하고 해당 콘텐츠를 가져올 수 있으며, 이를 통해 후속 추론 또는 요약 작업에 필요한 컨텍스트를 검색할 수 있습니다.