Pp Anac Pl

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/other/anac-pl/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

ANAC Pubblicità a Valore Legale — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the anac-pl-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install anac-pl --cli-only

2. Verify: anac-pl-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/other/anac-pl/cmd/anac-pl-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Usa questo CLI per cercare e analizzare programmaticamente bandi, esiti e avvisi pubblicati da stazioni appaltanti italiane sulla piattaforma ANAC. Ideale per monitoraggio appalti, due diligence e analisi dati con CSV/SQL.

Anti-triggers

Do not use this CLI for:

• Non usare per la Banca Dati Nazionale Contratti Pubblici (BDNCP) o l'anagrafe CIG completa.
• Non usare per inviare o pubblicare avvisi: l'API e' di sola lettura.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Stato locale che si accumula

• sync — Scarica e conserva gli avvisi in un database SQLite locale per analisi offline.

  Permette analisi ripetute e aggregazioni che l'API paginata non offre.

  anac-pl-pp-cli sync --resources avvisi --param keywords=microsoft

• search-local — Cerca tra gli avvisi gia' sincronizzati in locale, senza rete.

  Risposte istantanee e componibili con jq/SQL.

  anac-pl-pp-cli search-local microsoft

• export — Esporta gli avvisi sincronizzati in CSV o JSON per fogli di calcolo e pipeline dati.

  Porta i dati ANAC direttamente in strumenti di analisi.

  anac-pl-pp-cli export avvisi

Command Reference

avvisi — Ricerca e consultazione di bandi, esiti e avvisi pubblicati sulla Piattaforma di Pubblicità a Valore Legale ANAC

• anac-pl-pp-cli avvisi cronologia — Cronologia delle versioni/rettifiche di un avviso nel tempo
• anac-pl-pp-cli avvisi get — Dettaglio completo di un avviso/esito in formato JSON, incluse sezioni e committente
• anac-pl-pp-cli avvisi search — Ricerca full-text di avvisi (bandi, esiti, altri avvisi) con ranking di rilevanza e filtri

news — Avvisi e comunicazioni della piattaforma

• anac-pl-pp-cli news — Ultime news pubblicate sulla piattaforma

tipologie — Tassonomia delle tipologie di avviso (categorie, tipologie e codici scheda)

• anac-pl-pp-cli tipologie — Mappa di categorie, tipologie e codici scheda usati per filtrare la ricerca
• anac-pl-pp-cli tipologie schede — Describes notice scheda codes (AD3, A1_29, P1_16...) from ANAC's codiceScheda.json, offline; unknown code exits 3

cig — CIG tools

• anac-pl-pp-cli cig check <cig>... — Offline structure and check-digit validation (Simog, Simog v2/PCP, SmartCIG) with ANAC's published algorithm; a wrong check digit is a result (exit 0, check valido per code, jq -e 'all(.valido)' in scripts); an argument that is not CIG-shaped (length ≠ 10, bad first char) is a usage error, exit 2

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

anac-pl-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Matching is word-based, not semantic: a query scores on words that appear in a command name (cerca, avvisi, cpv, affidamenti, tipologie, ...) or in its description, ignoring common Italian and English filler words. Use the words of the domain (bandi, cpv, cronologia, affidamenti) rather than paraphrases: which "trova bandi recenti" resolves to avvisi search, which "chi ha vinto l'appalto" returns exit 2.

Search caveats

These come from how the ANAC search service behaves, not from the CLI. Check them before trusting a result set.

• Terms are OR-ed by default. --query words are matched in OR and ranked by relevance: the top results are usually on topic, lower ones may contain a single term. Quotes and + are silently ignored; AND is searched as a word and adds noise. For an exact phrase use cerca --mode esatta or avvisi search --fuzzy=false: words must be adjacent and in order, and a tipologia is required (the service answers HTTP 500 without one, so the CLI refuses first). Example: cerca -q "data visualization" --mode esatta -t affidamenti-diretti.
• Sorting is ignored with --query. --sort-field/--sort-dir only work without free text; the portal's own "Ordina per" has no effect either. To get recent notices, filter with --published-from GG/MM/AAAA. There is no filter on the deadline (dataScadenza).
• --scheda takes one tipologia, as a template number or name from tipologie list (4 or bandi, 7 or esiti). With comma-separated values the full-text search silently uses only the first, and notice codes such as AD3 or A1_29 make the service answer HTTP 500: the CLI rejects both.
• cerca --cpv is a text match, not a code filter: use cerca-avanzata --cpv to select by code. That flag also takes the official form with the check digit (30213000-5); the service ignores the check digit, and on a prefix it returns nothing, so the CLI refuses 302-5.
• There is no page number. The service paginates by token and silently ignores a page parameter, always returning the first page. Use cerca --pages N (or affidamenti --pages N) to walk N pages of --size results and get them merged, deduplicated by idAvviso; avvisi search --all follows continuation tokens up to 100 pages by default. Raise the safety limit with --max-pages N for broad searches. Reaching the limit returns an error rather than incomplete results. Without --all, --size controls the first page.
• The declared result count is an estimate that changes across pages and identical calls.
• titolo is often null (about 60% of notices, mostly AD3 and A2_* schede). descrizione is always set: read the notice subject from templates[].template.metadata.descrizione.
• A mistyped CIG returns unrelated notices, not an error. Run cig check <CIG> before searching by CIG; cerca --query and avvisi search --keywords warn on stderr when a CIG-shaped term fails the check digit.
• Obscured notices may be missing. Results carry oscurato/noteOscuramento; ANAC's guide says obscured notices can be excluded from search, and that the validation checks that trigger obscuring are currently disabled (always false in September 2026 samples).