Zotero plugin
Install the Ai4Scholar Zotero plugin, configure an API key, search papers, and import selected results into your personal library
Overview
The Ai4Scholar Zotero plugin searches Semantic Scholar from within Zotero. Filter the results and import selected bibliographic records into your personal library or a collection.
The current release is v1.0.3, compatible with Zotero 7, 8, 9, and 10 for desktop. It replaces the old cat icon with the website's Ai4 logo. The plugin's buttons currently use English; this guide uses their actual labels.
Installation
Steps
- Download ai4scholar-1.0.3.xpi. Keep the
.xpiextension; do not unzip it. - In Zotero's main window, open Tools → Plugins.
- Open the gear menu in the upper right of the plugin manager, choose Install Plugin From File…, and select the downloaded file. Some versions label this Install Add-on From File…. You can also drag the
.xpionto the plugin manager. - Make sure AI4Scholar - Semantic Scholar Search is enabled, then return to the main window and choose Tools → AI4Scholar Search. Restart Zotero if the menu has not appeared.
See Zotero's plugin installation instructions for the desktop installation process. The Zotero integration page also provides the download and compatibility details.

Configure your API key
- Sign in to Ai4Scholar and open API key management. Create a key or copy an active one.
- The first time you open AI4Scholar Search, the Enter API key dialog appears.
- Paste the key itself and click Save. Do not add a
Bearerprefix.
To replace the key later, click Settings at the bottom right of the search window and save the new value. The plugin uses an Ai4Scholar API key; no conversation model configuration is required.
Core features
Search papers
Enter keywords such as graph neural networks in Search papers..., then click Search or press Enter. Narrow the results with these filters:
| Field | How to use it |
|---|---|
| Year | Enter a From and To year, such as 2020–2026. Either end can be left blank. |
| Limit | Return up to 10, 20, 50, or 100 results per search. The default is 20. |
| Field | Select a discipline; All applies no discipline filter. |
| Min cites | Set a minimum citation count. Leave blank or enter 0 for no minimum. |
You can enter Chinese or English keywords. Results depend on Semantic Scholar's coverage. If no results appear, remove filters or try the paper's English title.
Import selected papers
- Check the papers you want, or click Select all to select all results from this search. Deselect all clears the selection.
- Choose a collection under Import to. My library imports into your personal library. Click New to create and select a new collection.
- Click Import (count). The status reports Imported successful/selected, for example
Imported 3/3. - Return to your Zotero library or the selected collection to review the titles, authors, years, abstracts, journal names, DOIs, and source links. Fields may be blank when the source does not provide them.
Imports currently target your personal library and its collections. Each import creates new items. Avoid importing successful results again; use Zotero to review and merge duplicates when needed.
Update the plugin
Open Tools → Plugins, then choose Check for Updates from the gear menu. Enable Update Plugins Automatically to let Zotero check for plugin updates automatically.
Existing installations can upgrade to v1.0.3. You can also download the .xpi from this page and install it over the existing version with Install Plugin From File…, without uninstalling first. After updating, check that the version is 1.0.3 and the new Ai4 icon appears.
Billing
Paper searches call Ai4Scholar through your API key, consume account credits according to endpoint rules, and are subject to the key's spending limit. Importing results already returned by a search is a local operation and does not make another paper search request.
Web-only free allowances do not imply free plugin or API usage. See Credits and plans and the Open API guide for details.
FAQ
Why is there no PDF after importing?
The plugin imports bibliographic records and source links. It does not automatically download PDF attachments, generate AI summaries, or send content to the writing editor. For full text, open the source link in Zotero or use Zotero's own full-text retrieval and attachment features.
How do I resolve an API error?
- 401: Check that your Ai4Scholar key is complete and active in Settings, with no
Bearerprefix. - 402 or an insufficient-credits error: Check both your account credits and the key's separate spending limit.
- 429: Requests are too frequent; wait before trying again.
- Other errors: Check your connection and the error message before deciding whether to retry.
Why is AI4Scholar Search missing from the Tools menu?
Return to Zotero's main library window. Check that the plugin is enabled, the installed version is correct, and you are using Zotero 7–10 for desktop. Restart Zotero if needed.
What if only some papers were imported?
Review the items already saved in the target collection, then select only the unsuccessful results again. If the target collection was deleted, choose My library or another valid collection before importing.