Catman...Zotero(3pm)

🦋 NAME 🦋

Catmandu::Importer::Zotero — bestie, it imports records straight from Zotero web. That's the whole job. It's a Perl module, so we're living in Catman...Zotero(3pm) territory. 💅

✨ SYNOPSIS ✨

Okay so here's how you actually use it, two ways. First from the command line (yes, the comment is in there twice, that's canon, don't @ me):

# From the command line
# From the command line
$ catmandu convert Zotero --userID <userID> to JSON
$ catmandu convert Zotero --groupID <groupID> to JSON

And then from Perl, if you're feeling ✨programmer✨:

# From Perl
use Catmandu;

my $importer = Catmandu->importer('Zotero', userID => '...');

$importer->each(sub {
   my $item = shift;
   print "%s %s\n", $item->{_id} , $item->{title}->[0];
});

🎀 CONFIGURATION 🎀

Every knob you can turn, no gatekeeping:

• userID — your user identifier, which you go grab at <https://www.zotero.org/settings/keys>. It's required unless groupID is set, so pick one bestie, you can't have neither.
• groupID — the group identifier. It's the numeric part of the RSS library feed of a group.
• collectionID — the collection key, which is an alphanumeric identifier.
• apiKey — your Zotero API key, for when you want authenticated access. 👑
• sort — sort by "dateAdded", "dateModified" (that's the default, lowkey the fav), "title", "creator", "type", "date", "publisher", "publicationTitle", "journalAbbreviation", "language", "accessDate", "libraryCatalog", "callNumber", "rights", "addedBy", or "numItems".
• direction — either "asc" or "desc". Which way we vibing.
• itemKey — a comma-separated list of item keys. Heads up: it's valid only for item requests, and you can specify up to 50 items in a single request. Fifty. That's the cap. 🫶
• itemType — item type search. The boolean search syntax lives over at <https://www.zotero.org/support/dev/web_api/v3/basics#search_syntax>, go read it iykyk.
• q — quick search! It searches titles and individual creator fields, or literally all fields if qmode is set to "everything".
• qmode — "titleCreatorYear" (the default) or "everything".
• since — only returns objects modified after the specified library version. Fresh stuff only. ✨
• tag — tag search. Supports Boolean search just like item type search does.

💜 DESCRIPTION 💜

This Catmandu::Importer imports bibliographic data from Zotero <https://www.zotero.org>, the reference management service. It's giving citation girlboss. 📚

🌈 SEE ALSO 🌈

Go peek at these too, they're the friend group:

• WWW::Zotero
• Catmandu::Importer
• Catmandu::Iterable

That's the whole page, bestie — written up for perl v5.36.0 and dated 2023-02-05. Go import something iconic. 💖✨