pp-eu-tenders - SKILL.md Agent Skill

name: pp-eu-tenders description: "The entire EU public procurement corpus — €815B/year — searchable offline, with B2B lead generation for... Trigger phrases: find EU procurement contracts, search TED tenders, who wins EU IT contracts in Germany, open tenders expiring soon, public procurement analysis, EU contract opportunities, use eu-tenders, run eu-tenders-pp-cli." author: "Mathias Michel" license: "Apache-2.0" argument-hint: " [args] | install cli|mcp" allowed-tools: "Read Bash" metadata: openclaw: requires: bins: - eu-tenders-pp-cli install: - kind: go bins: [eu-tenders-pp-cli] module: github.com/mvanhorn/printing-press-library/library/sales-and-crm/eu-tenders/cmd/eu-tenders-pp-cli

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:

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 eu-tenders --cli-only
```
Verify: eu-tenders-pp-cli --version
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.4 or newer):

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.
```
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.
```
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.
```
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.
```
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.
```
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.
```
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.
```
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.
```
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.
```
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:

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

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

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.

Is this market worth entering?

eu-tenders-pp-cli win-rate --cpv 72000000 --country FRA --since 2022-01-01 --show-winners --agent --select market.repeat_rate,market.unique_winner_count,market.top_winners

Check repeat-winner rate before investing proposal effort in French IT services.

Competitor intelligence

eu-tenders-pp-cli concentration --cpv 72000000 --country DEU --top 5 --since 2022-01-01 --agent --select winners.name,winners.share,winners.total_value

See which firms dominate German IT procurement and their market share.

Buyer deep-dive before a bid

eu-tenders-pp-cli buyer --name "Bundesagentur für Arbeit" --since 2020-01-01 --show-winners --agent --select profile.cpv_mix,profile.avg_value,profile.repeat_winner_rate,profile.avg_call_to_award_days

Build a full dossier on a buyer before writing a proposal — understand their preferences and incumbent relationships.

Sync + SQL analysis

eu-tenders-pp-cli sync --country DEU --cpv 72000000 --since 2023-01-01 && eu-tenders-pp-cli sql "SELECT buyer_name, COUNT(*) AS calls, AVG(estimated_value) AS avg_value FROM notices WHERE notice_type='cn-standard' GROUP BY buyer_name ORDER BY calls DESC LIMIT 20"

Pull data locally then run arbitrary SQL — works offline, composable with duckdb or pandas.

Auth Setup

No authentication required.

Run eu-tenders-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

Pipeable — JSON on stdout, errors on stderr
Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
```
eu-tenders-pp-cli notices --agent --select id,name,status
```
Previewable — --dry-run shows the request without sending
Non-interactive — never prompts, every input is a flag
Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests

Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

eu-tenders-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
eu-tenders-pp-cli feedback --stdin < notes.txt
eu-tenders-pp-cli feedback list --json --limit 10

Entries are stored locally at ~/.eu-tenders-pp-cli/feedback.jsonl. They are never POSTed unless EU_TENDERS_FEEDBACK_ENDPOINT is set AND either --send is passed or EU_TENDERS_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

Output Delivery

Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Sink	Effect
`stdout`	Default; write to stdout only
`file:<path>`	Atomically write output to `<path>` (tmp + rename)
`webhook:<url>`	POST the output body to the URL (`application/json` or `application/x-ndjson` when `--compact`)

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

Named Profiles

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

eu-tenders-pp-cli profile save briefing --json
eu-tenders-pp-cli --profile briefing notices
eu-tenders-pp-cli profile list --json
eu-tenders-pp-cli profile show briefing
eu-tenders-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.

Exit Codes

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

Argument Parsing

Parse $ARGUMENTS:

Empty, help, or --help → show eu-tenders-pp-cli --help output
Starts with install → ends with mcp → MCP installation; otherwise → see Prerequisites above
Anything else → Direct Use (execute as CLI command with --agent)

MCP Server Installation

Install the MCP server:

go install github.com/mvanhorn/printing-press-library/library/sales-and-crm/eu-tenders/cmd/eu-tenders-pp-mcp@latest

claude mcp add eu-tenders-pp-mcp -- eu-tenders-pp-mcp

Verify: claude mcp list

Direct Use

Check if installed: which eu-tenders-pp-cli If not found, offer to install (see Prerequisites at the top of this skill).
Match the user query to the best command from the Unique Capabilities and Command Reference above.

Execute with the --agent flag:

eu-tenders-pp-cli <command> [subcommand] [args] --agent

If ambiguous, drill into subcommand help: eu-tenders-pp-cli <command> --help.