zotero-scholar

What This Skill Does

The Zotero Scholar skill is an automated productivity tool designed for researchers, academics, and students to seamlessly bridge the gap between AI-driven research and bibliography management. It acts as an integration layer between your research discovery process and your Zotero reference manager. By leveraging the Zotero API, it automatically populates your library with structured metadata, including titles, authorship, primary source URLs, abstracts, and AI-generated analytical summaries. This eliminates the tedious manual entry process of adding new research papers to your library, ensuring your digital workspace remains organized and up-to-date with your latest findings.

Installation

To install this skill, use the ClawHub command-line interface. Ensure you have the OpenClaw environment initialized in your workspace:

clawhub install openclaw/skills/skills/gloamingblue/zotero-paper

After installation, you must configure your Zotero credentials to enable secure access to your account. Set the ZOTERO_CREDENTIALS environment variable in your system or project .env file using the format userid:apiKey. Your user ID and API key can be retrieved from your Zotero account settings under the 'Feeds/API' section.

Use Cases

• Automated Literature Review: Streamline your review process by having the agent save every relevant paper discussed during a chat directly into a 'To Review' folder in Zotero.
• Metadata Archiving: Standardize your library by ensuring every imported paper has a consistently formatted author list, title, and AI-generated summary attached as a note.
• Collaborative Research Workflows: Integrate Zotero into your CI/CD research pipelines, where scripts automatically log every paper evaluated by an AI model into a centralized reference database.

Example Prompts

1. "I'm currently reading 'Attention Is All You Need'. Can you save the metadata and the arXiv URL to my Zotero library, and please add a summary highlighting the multi-head attention mechanism?"
2. "After analyzing this paper on transformer architectures, please add it to my Zotero database with the tag 'machine-learning' and 'transformer', using the abstract provided in the PDF."
3. "Save the paper from this URL to Zotero. Make sure to list all authors correctly and include the AI summary I just generated as a note in the entry."

Tips & Limitations

• Rate Limiting: Be aware of Zotero's API rate limits. If you are syncing a large volume of papers simultaneously, consider implementing a small delay between requests to avoid getting temporarily blocked.
• Data Accuracy: While the AI provides the summary, always verify the authorship and publication year metadata, as parsing complex academic PDFs can occasionally result in minor formatting discrepancies.
• Duplicates: The skill uses the URL provided to check for existing entries; ensure the URL is the direct link to the paper (like an arXiv landing page) to optimize the deduplication process.