pp-eu-tenders

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/sales-and-crm/eu-tenders/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/". -->

# TED (Tenders Electronic Daily) — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `eu-tenders-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:
   ```bash
   npx -y @mvanhorn/printing-press-library install eu-tenders --cli-only
   ```
2. Verify: `eu-tenders-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.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/sales-and-crm/eu-tenders/cmd/eu-tenders-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

Reach for eu-tenders-pp-cli when you need to analyze EU public procurement at scale: scanning for bid opportunities, researching buyer behavior, studying market concentration, or building procurement data pipelines. It is the right tool when you need composable, scriptable access to TED data without paying €500+/month for a SaaS portal. Not the right choice for non-EU procurement (use SAM.gov or national portals instead).

## When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

## Unique Capabilities

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

### Lead generation
- **`leads`** — Surface recent construction contract award winners as B2B outreach candidates — company name, project location, contract value, and construction type — so you can contact winners who need construction machinery.

  _Reach for this when prospecting construction companies for B2B outreach — it identifies firms that just won large projects and will need equipment, subcontractors, and services in the near term._

  ```bash
  eu-tenders-pp-cli leads --cpv 45 --country DEU --region NW --min-value 500000 --days 30 --agent --select leads.winner_name,leads.project_location,leads.contract_value,leads.contact_url
  ```

### Market intelligence
- **`win-rate`** — See what fraction of contract competitions in a market go to new winners vs. incumbents — your real odds before writing a proposal.

  _Reach for this when deciding whether a procurement market is worth entering — high repeat-winner rate means the contract is effectively pre-determined._

  ```bash
  eu-tenders-pp-cli win-rate --cpv 72000000 --country FRA --min-calls 5 --show-winners --agent
  ```
- **`concentration`** — Compute which companies capture what share of awarded contract value in a sector and country, with HHI score and year-over-year trend.

  _Reach for this when researching market structure, competitive dynamics, or potential regulatory concentration issues in EU procurement._

  ```bash
  eu-tenders-pp-cli concentration --cpv 72000000 --country DEU --top 5 --since 2022-01-01 --agent
  ```
- **`velocity`** — See whether a procurement market is heating up, cooling off, or spiking — weekly notice count trends over rolling windows vs. same period last year.

  _Use this to spot demand surges in your sector before competitors react — especially useful after policy announcements or budget cycles._

  ```bash
  eu-tenders-pp-cli velocity --country DEU --cpv 72000000 --window 90d --compare 1y --agent
  ```
- **`cpv-drift`** — See which procurement categories are growing or shrinking in a country's spending mix year-over-year — essential for platform builders and policy researchers.

  _Use this to identify which procurement markets are expanding and worth investing in — particularly useful after major policy shifts like digital transformation mandates._

  ```bash
  eu-tenders-pp-cli cpv-drift --country DEU --since 2020-01-01 --top 20 --metric value --agent
  ```

### Bid intelligence
- **`score`** — Get a ranked shortlist of open tenders scored by deadline urgency, contract value, keyword fit, and market openness — your morning briefing, prioritized.

  _Use this when you need to decide which tenders deserve proposal effort today — it surfaces fit + urgency + openness in a single ranked list._

  ```bash
  eu-tenders-pp-cli score --keywords "cloud migration" --country DEU --cpv 72 --min-value 500000 --max-days 30 --agent
  ```
- **`buyer`** — Build a full procurement dossier on any contracting authority: their spending cadence, CPV mix, typical contract values, and repeat winner patterns.

  _Reach for this when preparing a bid to a specific buyer — understand their preferences, typical timelines, and incumbent relationships before writing._

  ```bash
  eu-tenders-pp-cli buyer --name "Bundesagentur für Arbeit" --since 2020-01-01 --show-winners --agent
  ```
- **`deadline-heat`** — A ranked calendar of expiring tenders weighted by urgency × value / competition density — your daily prioritized view of what needs attention now.

  _Use this as a daily morning briefing command — it surfaces high-urgency, high-value, low-competition opportunities that a simple deadline sort misses._

  ```bash
  eu-tenders-pp-cli deadline-heat --country DEU --cpv 72 --days 14 --min-value 200000 --agent
  ```

### Compliance & integrity
- **`dark-buyers`** — Surface contracting authorities whose calls-for-tender rarely produce public awards, or whose awards show suspiciously low winner diversity — a compliance and integrity signal.

  _Reach for this when investigating procurement compliance, building risk scores for contracting authorities, or preparing investigative journalism._

  ```bash
  eu-tenders-pp-cli dark-buyers --country POL --cpv 45000000 --since 2022-01-01 --min-calls 3 --agent
  ```

## Command Reference

**notices** — Manage notices

- `eu-tenders-pp-cli notices` — Search for notices using expert search query. More information about the query format and field names can be found...


### Finding the right command

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

```bash
eu-tenders-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.

## Recipes


### Construction machinery lead generation

```bash
eu-tenders-pp-cli leads --cpv 45 --country DEU --region NW --min-value 500000 --days 30 --agent --select leads.winner_name,leads.project_location,leads.contract_value,leads.construction_type,leads.contact_url
```

Find recent construction contract award winners in German North Rhine-Westphalia — companies that just won large projects and will need cranes, containers, and site equipment.

### Morning bid opportunity briefing

```bash
eu-tenders-pp-cli deadline-heat --country DEU --cpv 72 --days 14 --min-value 200000 --agent --select notices.score,notices.title,notices.buyer_name,notices.deadline,notices.estimated_value
```

Run daily to surface the highest-urgency, highest-value open tenders in German IT.

###