MCPInstall

gs-export

Export Google Scholar paper(s) to Zotero via BibTeX. Gets citation data from Google Scholar's cite dialog, then pushes to Zotero desktop. Supports single or batch export.

Installs
203
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/cookjohn/gs-skills --skill gs-export
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads gs-export automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Google Scholar Export to Zotero

Export Google Scholar paper citation data via BibTeX extraction and push to Zotero desktop.

Arguments

$ARGUMENTS contains one or more data-cids (space-separated), e.g.:

  • TFS2GgoGiNUJ — single paper
  • TFS2GgoGiNUJ abc123XYZ def456UVW — batch export

Steps

Step 1: Get BibTeX for each paper

For each data-cid, perform 3 tool calls to bypass CORS:

1a. Fetch cite dialog to get BibTeX link (evaluate_script)

async () => {
  const cid = "DATA_CID_HERE";
  const resp = await fetch(
    `https://scholar.google.com/scholar?q=info:${cid}:scholar.google.com/&output=cite`,
    { credentials: 'include' }
  );
  const html = await resp.text();
  const doc = new DOMParser().parseFromString(html, 'text/html');

  // Extract export links
  const links = Array.from(doc.querySelectorAll('#gs_citi a')).map(a => ({
    format: a.textContent.trim(),
    url: a.href
  }));

  // Extract citation format texts
  const citations = Array.from(doc.querySelectorAll('#gs_citt tr')).map(tr => {
    const cells = tr.querySelectorAll('td');
    return {
      style: cells[0]?.textContent?.trim() || '',
      text: cells[1]?.textContent?.trim() || ''
    };
  });

  const bibtexLink = links.find(l => l.format === 'BibTeX');
  return { cid, bibtexLink: bibtexLink?.url || '', links, citations };
}

1b. Navigate to BibTeX URL (navigate_page)

Use mcp__chrome-devtools__navigate_page:

  • url: the bibtexLink URL from step 1a (on scholar.googleusercontent.com)

This bypasses CORS restrictions that block fetch() to googleusercontent.com.

1c. Read BibTeX content (evaluate_script)

async () => {
  return { bibtex: document.body.innerText || document.body.textContent || '' };
}

Step 2: Parse BibTeX and push to Zotero

Save the BibTeX data as JSON, then call the push script:

python "E:/gscholar-skills/.claude/skills/gs-export/scripts/push_to_zotero.py" /tmp/gs_papers.json

Before calling the script, construct a JSON file at /tmp/gs_papers.json containing paper data parsed from BibTeX. Parse the BibTeX yourself and create the JSON array:

[
  {
    "pmid": "",
    "title": "The title from BibTeX",
    "authors": [
      {"lastName": "Smith", "firstName": "John"}
    ],
    "journal": "Journal Name",
    "journalAbbr": "",
    "pubdate": "2022",
    "volume": "14",
    "issue": "4",
    "pages": "1054",
    "doi": "",
    "pdfUrl": "https://example.com/paper.pdf",
    "abstract": "",
    "keywords": [],
    "language": "en",
    "pubtype": ["Journal Article"]
  }
]

IMPORTANT: Set pdfUrl from the search result's fullTextUrl field (the PDF link extracted by gs-search). The Python script will download the PDF and upload it to Zotero via /connector/saveAttachment (Zotero 7.x ignores attachments in saveItems). PDF download may fail for some publishers (403, JS-redirect); these are reported as "PDF skip".

BibTeX fields mapping:

  • @article{key, → itemType: journalArticle
  • @inproceedings{key, → itemType: conferencePaper
  • @book{key, → itemType: book
  • title={...} → title
  • author={Last1, First1 and Last2, First2} → authors array
  • journal={...} → journal
  • year={...} → pubdate
  • volume={...} → volume
  • number={...} → issue
  • pages={...} → pages
  • publisher={...} → (included in extra or publisher field)

Step 3: Report

Single paper:

Exported to Zotero from Google Scholar:
  Title: {title}
  Authors: {authors}
  Journal: {journal} ({year})
  Data-CID: {dataCid}

Batch:

Exported {count} papers to Zotero from Google Scholar:
  1. {title1} ({journal1}, {year1})
  2. {title2} ({journal2}, {year2})
  ...

Batch Export Optimization

For multiple papers, process sequentially to avoid CAPTCHA:

  1. Get all BibTeX links in one evaluate_script call (fetch all cite dialogs)
  2. Navigate to each BibTeX URL one at a time
  3. Collect all BibTeX entries
  4. Push all to Zotero in a single batch

Notes

  • Single paper export uses 3-4 tool calls: evaluate_script (cite dialog) + navigate_page (BibTeX URL) + evaluate_script (read BibTeX) + bash python (Zotero push)
  • Batch export: 2N+1 tool calls (N papers: N navigate + N evaluate + 1 bash)
  • BibTeX links are on scholar.googleusercontent.com — CORS blocks fetch(), so we use navigate_page to bypass
  • Reuses push_to_zotero.py for Zotero Connector API communication
  • Google Scholar BibTeX does NOT include abstract or DOI — these fields will be empty in Zotero
  • After export, navigate back to Google Scholar page: navigate_page with type back

FAQ

What does the gs-export skill do?

Export Google Scholar paper(s) to Zotero via BibTeX. Gets citation data from Google Scholar's cite dialog, then pushes to Zotero desktop. Supports single or batch export.

How do I install gs-export?

Run npx skills add https://github.com/cookjohn/gs-skills --skill gs-export in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/gs-export/ (personal) or .claude/skills/gs-export/ (project).

Which AI agents can use gs-export?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is gs-export safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains gs-export?

It is published by cookjohn in cookjohn/gs-skills. It has 203 recorded installs.

More from cookjohn/gs-skills

View all →

gs-search

cookjohn/gs-skills

Search Google Scholar for academic papers by keywords. Returns results with title, authors, journal, year, citation count, and full-text links. Use when the user wants to search Google Scholar.

gs-fulltext

cookjohn/gs-skills

Open the skill to read its SKILL.md instructions.

291 installs

gs-advanced-search

cookjohn/gs-skills

Open the skill to read its SKILL.md instructions.

231 installs

gs-cited-by

cookjohn/gs-skills

Open the skill to read its SKILL.md instructions.

204 installs

gs-navigate-pages

cookjohn/gs-skills

Navigate Google Scholar search result pages. Use when user wants to see more results or go to a specific page.

159 installs

Popular education & science skills

View category →

teach

mattpocock/skills

Teach the user a new skill or concept, within this workspace.

Education & Science874K installs

scaffold-exercises

mattpocock/skills

Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.

Education & Science488.2K installs

paper-context-resolver

lllllllama/rigorpilot-skills

Rigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing README guidance by default.

Education & Science478.3K installs

caveman-learn

juliusbrussee/caveman

Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.

Education & Science107.9K installs

gsap-plugins

greensock/gsap-skills

Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration.

Education & Science67.9K installs

teach-impeccable

pbakaus/impeccable

DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.