Kỹ năng Notion do nhà phát triển cá nhân intellectronica viết: không dùng MCP, cho phép tác nhân gọi trực tiếp Notion REST API bằng curl và jq để tìm kiếm nội dung, đọc/ghi trang và khối, truy vấn và tạo cơ sở dữ liệu cùng nguồn dữ liệu, đọc/ghi bình luận; trong SKILL.md có ví dụ yêu cầu cho từng endpoint.
Số lượt cài đặt trên skills.sh 98110 (+518 / 24h)
Kiểm toán bảo mật: Chưa kiểm toán
- Chưa quét
Lý do
- Xử lý thông tin đăng nhập rõ ràng: trước tiên tìm biến môi trường NOTION_API_TOKEN, sau đó dùng token người dùng cung cấp trong cuộc trò chuyện, nếu không có thì hỏi người dùng; yêu cầu Token chỉ được đặt trong tiêu đề yêu cầu Authorization, không hiển thị và không ghi vào nhật ký
- Xác nhận trước khi thay đổi: cập nhật trang hoặc khối, lưu trữ/xóa, thay đổi cấu trúc cơ sở dữ liệu, tạo hàng loạt trang đều phải hỏi người dùng trước, xác nhận một lần cho mỗi nhóm thao tác liên quan
- Được viết theo Notion-Version 2025-09-03, bao phủ các giao diện nguồn dữ liệu (data source) mới; kèm theo cách viết phân trang, cơ chế backoff khi bị giới hạn tốc độ 429 và giới hạn kích thước yêu cầu
- Kho lưu trữ có giấy phép CC0; trên skills.sh, số lượt cài đặt trong 24 giờ là 518, tổng cộng 98110, trong 8 tuần gần đây số lượt cài đặt hàng tuần tăng từ 2335 lên 5232 (chỉ phản ánh mức độ quan tâm)
Cách dùng
- Lệnh cài đặt sẽ hiển thị sau khi qua kiểm toán; kích hoạt khi yêu cầu tác nhân “đọc / sửa trang Notion” hoặc “truy vấn cơ sở dữ liệu Notion”
- Cần Token API cho tích hợp Notion (đặt làm biến môi trường NOTION_API_TOKEN), máy cục bộ cần có curl và jq
Rủi ro
- Chưa được kiểm toán trong kỳ này, xếp loại C cố định, không hiển thị lệnh cài đặt; SKILL.md cho phép tác nhân thực thi curl để truy cập api.notion.com và đọc NOTION_API_TOKEN, phù hợp với mục đích sử dụng; trên skills.sh, Gen Agent Trust Hub đánh giá kiểm toán là Pass
- Không phải sản phẩm chính thức của Notion; nếu dán Token vào cuộc trò chuyện, nó sẽ lưu lại trong lịch sử chat, dùng biến môi trường an toàn hơn
- Tác nhân có khả năng lưu trữ trang và xóa khối, việc xác nhận trước phụ thuộc vào sự tuân thủ của tác nhân; các ví dụ có thể trở nên lỗi thời sau khi phiên bản Notion API cập nhật