zotero_create_area_annotation
Create a rectangular annotation on a specific PDF page to highlight figures, diagrams, or tables. Specify page number and normalized coordinates for the rectangle.
Instructions
Create a PDF AREA/IMAGE annotation — a rectangle drawn on an arbitrary page region (figures, diagrams, tables, non-text content). For highlighting selectable text, use zotero_create_annotation instead. attachment_key: PDF attachment key — NOT the parent item key (use zotero_get_item_children to find attachments). page: 1-indexed page number (page 1 is the first page). x, y: top-left corner in NORMALIZED page coordinates in [0, 1] — (0, 0) is the page's top-left, (1, 1) is the bottom-right. width, height: rectangle size, also normalized to [0, 1] and relative to the page (not to x, y). comment: optional note attached to the annotation. color: hex color (default '#ffd400' yellow). Scope: PDFs only — EPUB attachments are NOT supported. Requires a writable library (web API key or hybrid mode) — fails in local-only mode. Example: zotero_create_area_annotation(attachment_key='NHZFE5A7', page=7, x=0.15, y=0.22, width=0.6, height=0.35, comment='Figure 3 — mean completion rates').
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| attachment_key | Yes | PDF attachment key (e.g., "NHZFE5A7") | |
| page | Yes | 1-indexed PDF page number | |
| x | Yes | Normalized left coordinate (0..1) | |
| y | Yes | Normalized top coordinate (0..1) | |
| width | Yes | Normalized width (0..1) | |
| height | Yes | Normalized height (0..1) | |
| comment | No | Optional comment on the annotation | |
| color | No | Annotation color in hex format | #ffd400 |
| tags | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |