Check Watches
check_watchesRead-only
Retrieve new papers matching your watches since the last digest delivery. Optionally scope to a specific watch or check all watches. Read-only and safe to call repeatedly.
Instructions
Pull new matching papers since the last digest delivery, in the same shape as search_papers results. Optionally scope to one watch by watch_name OR watch_id; omit both for all watches. Read-only and idempotent — does NOT advance any watermark (only digest delivery does), so it is safe to call repeatedly (no mark-on-read). This is the in-session 'anything new on my watches?' pull. Requires SF_API_KEY.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| watch_name | No | Scope to one watch by name. Provide this OR watch_id, or neither for all. | |
| watch_id | No | Scope to one watch by UUID. Provide this OR watch_name, or neither for all. | |
| limit | No | Max hits to return (max 100). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| papers | No | Matched / returned papers. | |
| total | No | Total results available for the query. | |
| page | No | ||
| limit | No | ||
| mode | No | Search mode actually applied. | |
| direction | No | Citation direction (get_citations: citing | cited_by). | |
| topic | No | ||
| note | No | ||
| not_found | No | Requested IDs that had no match. | |
| next_cursor | No | Keyset cursor for the next page, or null when exhausted. | |
| hits | No | New watch matches (check_watches). | |
| results | No |