zotero_add_by_url
Add a publication to Zotero from a DOI, arXiv link, or webpage URL. Fetches metadata and attaches PDF automatically based on URL type.
Instructions
Add an item to the active Zotero library from a URL. Routes by URL shape: doi.org/... → CrossRef metadata (same path as zotero_add_by_doi); arxiv.org/abs/... → arXiv metadata + PDF; anything else → webpage item (title + URL, minimal metadata). Prefer zotero_add_by_doi when you have a clean DOI — it skips the routing and is more robust. For a local file use zotero_add_from_file. url: the URL to import. collections: optional list of 8-character collection keys (or names) to file the item under. tags: optional list of tag strings to attach. attach_mode: 'auto' (default) attaches a PDF if one is available; 'none' skips; 'required' fails if no PDF can be attached. PDF uploads may fail on the Zotero cloud free-tier 300MB quota — metadata still lands even when the upload fails. WARNING: for bibliography use, a general web-page URL produces a 'webpage' itemType that often isn't acceptable as a citation; resolve to a DOI and use zotero_add_by_doi instead when possible. Requires a writable library (fails in local-only mode). Run zotero_update_search_database afterwards for semantic search. Example: zotero_add_by_url(url='https://arxiv.org/abs/2602.14878', collections=['9SU943GB']).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| collections | No | ||
| tags | No | ||
| attach_mode | No | auto |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |