NAME

App::wdq - command line access to Wikidata Query Service

DESCRIPTION

The command line script wdq, included in CPAN module App::wdq, provides a tool to access Wikidata Query Service. It supports formulation and execution of SPARQL SELECT queries to extract selected information from Wikidata or other Wikibase instances.

INSTALLATION

Either install from CPAN with all dependencies:

cpanm App::wdq

or install dependencies as prebuild packages (for instance Debian) and copy the wdq script to some place in your $PATH:

sudo apt-get install libhttp-tiny-perl librdf-query-perl
wget https://github.com/nichtich/wdq/raw/master/bin/wdq
chmod +x wdq

The latter method will not install this documentation.

USAGE

Get a documented list of all command line options:

 wdq --help

query mode (default)

Pass a (possibly abbreviated) SPARQL query via STDIN or option --query.

lookup mode

Pass a line-separated list of Wikidata identifiers or Wikimedia project URLs.

EXAMPLES

# get all parts of the solar system
wdq -q '?c wdt:P361 wd:Q544'

# get all references used at an item
wdq -q 'wd:Q1 ?prop [ prov:wasDerivedFrom ?ref ]'

# print expanded SPARQL query 
wdq -n -q '?c wdt:P361 wd:Q544'

# execute query and return first 10 tab-separated values
wdq -f tsv --limit 10 < query

# execute query, abbreviate Wikidata identifier, emit simple JSON
wdq -f simple --ids < query

# print result as Markdown Table (requires Catmandu::Exporter::Table)
wdq --export Table < query

# look up label and description 
echo Q1 | wdq lookup

# look up German Wikipedia article and get label description in French
echo http://de.wikipedia.org/wiki/Argon | wdq lookup -g fr

COPYRIGHT AND LICENSE

Copyright Jakob Voss, 2015-

GPL 2.0