cue-ai 0.9.1 → 0.9.2

package/resources/skills/skills/career/salary-negotiation-prep/SKILL.md

@@ -0,0 +1,378 @@
+---
+name: salary-negotiation-prep
+description: Research market comp bands, build a negotiation strategy, and write counter-offer scripts. Use when user says "negotiate my offer", "salary negotiation", "counter offer", "what should I ask for", "is this offer fair", "they lowballed me", or "how much should I counter".
+---
+
+# Salary Negotiation Prep
+
+## When to Use This Skill
+
+Use this skill when the user wants to:
+- Negotiate a job offer or salary
+- Research market rates for their role
+- Create a counter-offer strategy
+- Understand total compensation packages
+- Mentions: "salary negotiation", "negotiate offer", "counter offer", "compensation", "how much should I ask for"
+
+## Core Capabilities
+
+- Research and validate market compensation
+- Build negotiation strategy and scripts
+- Calculate total compensation (not just base salary)
+- Prepare counter-offer responses
+- Identify negotiation leverage points
+- Navigate difficult salary conversations
+
+## The Negotiation Mindset
+
+**Key Principles:**
+1. Negotiation is expected - companies budget for it
+2. 84% of employers expect candidates to negotiate
+3. Not negotiating leaves $500K-$1M on the table over a career
+4. The goal is win-win, not adversarial
+
+**What You're Really Negotiating:**
+- Base salary
+- Signing bonus
+- Annual bonus/commission
+- Equity (stock options, RSUs)
+- Benefits (401k match, insurance)
+- Perks (vacation, remote work, professional development)
+- Start date
+- Title
+
+## Research Phase
+
+### Step 1: Determine Market Rate
+
+**Sources to Check:**
+- Levels.fyi (best for tech)
+- Glassdoor (general, take with grain of salt)
+- LinkedIn Salary
+- Blind (anonymous reports)
+- PayScale
+- Salary.com
+- H1B salary data (publicly available)
+
+**Build a Range:**
+```
+Low (25th percentile): $XXX,XXX
+Target (50th percentile): $XXX,XXX  
+High (75th percentile): $XXX,XXX
+Stretch (90th percentile): $XXX,XXX
+```
+
+### Step 2: Know Your Value
+
+**Factors That Increase Your Worth:**
+- Years of relevant experience
+- Specialized/rare skills
+- Track record of results
+- In-demand certifications
+- Current competing offers
+- Referral from employee
+- Market demand in your field
+
+**Factors That May Limit:**
+- Entry level or career change
+- Less experience than ideal candidate
+- Gaps in required skills
+- Location arbitrage (lower cost of living)
+
+### Step 3: Calculate Total Compensation
+
+**Total Comp = Base + Bonus + Equity + Benefits**
+
+```
+EXAMPLE:
+Base Salary: $150,000
+Target Bonus (15%): $22,500
+RSU Grant (4-year): $200,000 ($50,000/year)
+401k Match (4%): $6,000
+Benefits Value: ~$15,000
+
+Total Annual Comp: $243,500
+```
+
+**Common Equity Terms:**
+- **RSUs:** Restricted Stock Units (real shares, taxed when vesting)
+- **Options:** Right to buy at strike price (value = current price - strike price)
+- **Vesting:** Typically 4-year with 1-year cliff
+- **Refresh grants:** Annual additional equity grants
+
+## Negotiation Strategy
+
+### When to Negotiate
+
+**Best Time:** After you have a written offer, before you sign
+
+**Timeline:**
+1. Receive verbal offer → Express enthusiasm, ask for written offer
+2. Receive written offer → Thank them, ask for time to review
+3. Research and prepare → 24-48 hours
+4. Counter with ask → Email or call
+5. Discussion/back and forth → May take several rounds
+6. Final agreement → Get in writing
+
+### The Counter-Offer Framework
+
+**Structure:**
+1. Express enthusiasm
+2. Reinforce your value
+3. Make specific ask
+4. Provide justification
+5. Open discussion
+
+### Counter-Offer Email Template
+
+```
+Subject: [Your Name] - Offer Discussion
+
+Hi [Recruiter/Hiring Manager],
+
+Thank you so much for the offer to join [Company] as [Title]. I'm very excited about the opportunity to [specific thing about the role]. After speaking with the team and learning more about [something specific], I'm confident this is the right fit.
+
+I've had time to review the offer details and wanted to discuss the compensation. Based on my research of the market and my [X years of experience / specific valuable skill / competing offer], I was hoping we could discuss a base salary of $[Your Ask] rather than $[Their Offer].
+
+[Optional: Add specific justification - e.g., "I've seen similar roles at [comparable companies] in this range" or "Given the scope of the role and my track record of [specific achievement], I believe this reflects my value."]
+
+I'm flexible and open to discussing other elements of the package as well. Would you have time for a quick call to discuss?
+
+Thank you again for this opportunity. I'm looking forward to finding a package that works for both of us.
+
+Best,
+[Your Name]
+```
+
+### Counter-Offer Call Script
+
+```
+"Hi [Name], thanks for making time. I'm really excited about this opportunity - [genuine specific reason].
+
+I've reviewed the offer and want to discuss compensation. Based on my market research and [X years experience / key accomplishment / competing offer], I was hoping for a base salary closer to $[Amount].
+
+Is there flexibility there?"
+
+[LISTEN - Let them respond]
+
+[If they push back:]
+"I understand there are constraints. I'm flexible - could we look at other elements like signing bonus, equity, or [other element] to bridge the gap?"
+
+[If they say they'll need to check:]
+"That's totally fair. When would be a good time to reconnect?"
+```
+
+## Common Negotiation Scenarios
+
+### Scenario 1: First Offer Is Low
+
+**Approach:**
+- Don't accept immediately
+- Express enthusiasm for role
+- Counter with research-backed number
+- Be prepared to justify
+
+**Script:**
+```
+"I'm thrilled about the opportunity. The base salary is lower than I expected based on my research. For this role and market, I was expecting something in the $X-$Y range. Is there room to move closer to $X?"
+```
+
+### Scenario 2: They Ask Your Salary Expectations First
+
+**Deflection Strategy:**
+```
+"I'm flexible and focused on finding the right fit. What's the range you've budgeted for this role?"
+```
+
+**If Pressed:**
+```
+"Based on my research for this role and market, I'm looking at $X-$Y, but I'm open to discussing the full compensation picture."
+```
+
+### Scenario 3: They Won't Budge on Base
+
+**Alternatives to Negotiate:**
+- Signing bonus (one-time, easier to approve)
+- Additional equity
+- Earlier performance review (sooner raise)
+- More vacation days
+- Remote work flexibility
+- Professional development budget
+- Title upgrade
+- Relocation assistance
+- Start date
+
+**Script:**
+```
+"I understand the base salary is firm. Could we discuss a signing bonus to help bridge the gap? Something in the range of $X would make this work."
+```
+
+### Scenario 4: You Have Competing Offers
+
+**Use Carefully:**
+- Only mention if true
+- Don't make it a threat
+- Frame as problem-solving
+
+**Script:**
+```
+"I want to be transparent - I'm also in discussions with [another company/a few other companies]. They're offering $X. [Your Company] is my first choice because [genuine reason], but I want to make sure the compensation is competitive."
+```
+
+### Scenario 5: They Ask About Current Salary
+
+**In Many States, This Question Is Illegal**
+
+**If Asked (and legal):**
+```
+"I'd prefer to focus on the value I'd bring to this role and what the market rate is. What's the range you've budgeted?"
+```
+
+**Or Redirect:**
+```
+"My current compensation isn't really comparable since [different location/role/structure]. Based on my research for this role, I'm targeting $X-$Y."
+```
+
+## Negotiation Tactics
+
+### Do's:
+- ✅ Always negotiate (respectfully)
+- ✅ Get the offer in writing before negotiating
+- ✅ Research thoroughly
+- ✅ Be specific with numbers
+- ✅ Express genuine enthusiasm
+- ✅ Give them a way to say yes
+- ✅ Consider total compensation
+- ✅ Be patient - process takes time
+- ✅ Get final agreement in writing
+
+### Don'ts:
+- ❌ Accept on the spot
+- ❌ Give a salary history (if not required by law)
+- ❌ Make ultimatums
+- ❌ Lie about competing offers
+- ❌ Be rude or aggressive
+- ❌ Negotiate just for the sake of it
+- ❌ Accept verbal promises without writing
+- ❌ Burn bridges if it doesn't work out
+
+## Total Compensation Comparison
+
+### Side-by-Side Analysis
+
+```markdown
+## OFFER COMPARISON
+
+| Component | Company A | Company B | Notes |
+|-----------|-----------|-----------|-------|
+| Base Salary | $150,000 | $140,000 | A wins |
+| Target Bonus | 15% ($22,500) | 20% ($28,000) | B wins |
+| Signing Bonus | $20,000 | $10,000 | A wins |
+| Equity (annual) | $50,000 | $75,000 | B wins |
+| 401k Match | 4% ($6,000) | 6% ($8,400) | B wins |
+| Benefits | Standard | Premium | B wins |
+| WFH | Hybrid (3 days) | Full remote | B wins |
+| Vacation | 3 weeks | Unlimited | Depends |
+
+**Year 1 Total Comp:**
+Company A: $248,500
+Company B: $261,400
+
+**Analysis:** Company B is higher total comp, but Company A has higher base which affects future raises and mortgage qualification.
+```
+
+## Negotiation Timeline Template
+
+```
+Day 1: Receive offer
+- Thank them, express enthusiasm
+- Ask for offer in writing
+- Ask deadline for response
+
+Day 1-3: Research
+- Verify market rate
+- Calculate total comp
+- Identify priorities
+- Prepare counter-offer
+
+Day 3-5: Counter
+- Send counter-offer email or schedule call
+- Be specific about ask
+
+Day 5-10: Discussion
+- May require several rounds
+- Be patient but responsive
+- Stay professional and positive
+
+Day 10+: Resolution
+- Agree on terms
+- Get everything in writing
+- Sign and celebrate!
+```
+
+## Output Format
+
+When preparing salary negotiation:
+
+```markdown
+# SALARY NEGOTIATION STRATEGY
+
+## Market Research Summary
+**Role:** [Title]
+**Location:** [City/Remote]
+**Experience Level:** [Years]
+
+**Market Range:**
+- 25th percentile: $XXX,XXX
+- 50th percentile: $XXX,XXX (target)
+- 75th percentile: $XXX,XXX
+- 90th percentile: $XXX,XXX (stretch)
+
+**Sources:** [List sources used]
+
+## Their Offer
+| Component | Amount |
+|-----------|--------|
+| Base | $XXX,XXX |
+| Bonus | X% |
+| Equity | $XXX,XXX |
+| Signing | $XXX |
+| Total Year 1 | $XXX,XXX |
+
+## Your Counter
+| Component | Ask | Justification |
+|-----------|-----|---------------|
+| Base | $XXX,XXX | [Why] |
+| Signing | $XXX | [Why] |
+| [Other] | | |
+
+## Counter-Offer Script
+[Email template or call script customized for this situation]
+
+## If They Push Back
+**Plan B:** [Alternative elements to negotiate]
+**Walk-away Point:** [Your minimum]
+
+## Key Talking Points
+1. [Your experience/value point]
+2. [Market data point]
+3. [Specific achievement]
+
+## Questions to Clarify
+- [Equity vesting schedule?]
+- [Bonus guaranteed?]
+- [Review cycle timeline?]
+```
+
+## Implementation Checklist
+
+1. ✅ Research market rate from 3+ sources
+2. ✅ Calculate total compensation (not just base)
+3. ✅ Identify your priorities
+4. ✅ Determine walk-away point
+5. ✅ Prepare counter-offer with justification
+6. ✅ Write or practice negotiation script
+7. ✅ Plan for pushback scenarios
+8. ✅ Get agreement in writing
+9. ✅ Review final offer letter carefully
+10. ✅ Sign and celebrate!

package/resources/skills/skills/eu-funding/grant-outreach/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: grant-outreach
+description: 'Use when user says "grant outreach", "propose grants to companies by email", "grant brokerage", or asks about HU/SK B2B cold-email rules. Matches a grant to a company, drafts a compliant pitch.'
+tags: [eu-funding, outreach, email, grants, compliance, hungary, slovakia]
+---
+
+# Grant outreach (HU / SK B2B)
+
+Turn the funding-research capability into an outreach motion: find a live grant,
+match it to companies that qualify, and email them a compliant proposal. This is a
+brokerage / lead-gen service (not a product). Find the grants first with [[hu-grant-finder]].
+
+## Compliance first (one complaint can outweigh a deal)
+
+HU and SK are **opt-in** countries for marketing email (SK: Act 351/2011 §62; HU: Grt.
++ GDPR). Cold B2B email is defensible only on **GDPR legitimate interest** (Art 6(1)(f)),
+and only done right:
+
+- Email **generic company addresses** (`info@`, `obchod@`), never named persons.
+- The pitch must be **genuinely relevant** (a grant the company actually qualifies for)
+  and tied to their professional role. That relevance *is* the legitimate interest.
+- **Identify yourself** (company, address) and give a **one-click opt-out** in every mail.
+- Keep a written **LIA** (legitimate interest assessment) and an opt-out / suppression log.
+- Throttle, and never re-email an opt-out.
+- Verify with the **Slovak DPA** (`dataprotection.gov.sk`) or **NAIH** (HU) or a lawyer
+  before scaling. This skill is not legal advice.
+
+## Workflow
+
+1. **Find a live grant** via [[hu-grant-finder]] (eligibility: sector, size, region, deadline).
+2. **Build a target list** of companies matching the eligibility, from public registers:
+   SK **ORSR** (`orsr.sk`) / **FinStat** (`finstat.sk`); HU **e-cégjegyzék** / Céginfo /
+   OPTEN. Keep only generic contact addresses.
+3. **Match + rank** each company to the grant: why they qualify, the amount, the deadline.
+4. **Draft** a short, personal email per company (use the `email-sequence-writer` skill for
+   the copy). Lead with their fit, not your service.
+5. **Send compliant** through an ESP with sender-ID + opt-out + throttle + suppression list.
+6. **Track** replies; price as success fee (% of grant won) or retainer.
+
+## Email skeleton (SK / HU, compliant)
+
+```
+Subject: <Program> – <amount> for <their sector> (deadline <date>)
+
+Dobrý deň / Tisztelt <Company>,
+
+<Program X> is open and your company looks eligible: <1-line why: sector, size, region>.
+It is <amount, %>, deadline <date>. Happy to send a 1-page fit check.
+
+<Your name>, <Company>, <address> · <phone>
+Unsubscribe: <link>   (we will not email again)
+```
+
+## Rules
+
+- Compliance is the gate, not an afterthought: generic address + real relevance +
+  sender-ID + opt-out + LIA, or do not send.
+- Relevance is the legitimate-interest argument. A grant the company cannot win is spam;
+  match eligibility hard first via [[hu-grant-finder]].
+- Never email a named individual or a scraped personal address; never re-email an opt-out.
+- This is outreach, not legal counsel. Flag the Slovak DPA / NAIH check before scaling.
+
+## Example
+
+User: "Let's offer Program Slovensko grants to other companies by email."
+
+Pull the open grant + eligibility via [[hu-grant-finder]], build a target list from
+ORSR / FinStat filtered to that eligibility, draft one relevant email per company to its
+generic address with sender-ID + opt-out, log the LIA, and send throttled. Flag that B2B
+cold email needs a legitimate-interest basis and a DPA check before scaling.

package/resources/skills/skills/eu-funding/hu-grant-finder/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: hu-grant-finder
+description: 'Use when user says "find grants", "pályázat", "támogatás", "GINOP", "DIMOP", "Hiventures", "EIC", or what funding a HU/SK company can apply for. Maps grants, loans, VC, not tenders.'
+tags: [eu-funding, grants, palyazat, ginop, hungary, venture-capital]
+---
+
+# Hungarian / EU grant & funding finder
+
+Map the funding a company can actually get, by channel and by stage. Built for
+agentic-AI / IT companies in Hungary (extendable to SK). **Grants are not tenders**, 
+for public procurement (selling to the state) use [[ted-tender-search]].
+
+## First: pick the right channel (they get confused constantly)
+
+| Channel | What it is | You... | Repay? |
+|---|---|---|---|
+| **Közbeszerzés / tender** | TED procurement | *sell* services to the state | no (you earn) |
+| **Támogatás / grant** | GINOP/DIMOP, EU grants | get non-repayable money for a project | no |
+| **Kedvezményes hitel** | MFB / GINOP loan programs | borrow cheap (often 0%) | **yes** |
+| **Kockázati tőke / VC** | Hiventures, EIC, EU funds | take equity investment | no, but give **equity** |
+
+## The funding ladder (Hungarian micro/IT company)
+
+```
+ 0 lezárt év          1+ lezárt üzleti év            deep-tech / scalable product
+ ──────────           ──────────────────             ───────────────────────────
+ Vállalkozóvá válás   KKV grants & 0% loans          Hiventures (GINOP 2.5.1, ≤€300k)
+ (NFSZ, ~4,9M Ft,     (DIMOP/GINOP — when a round    EIC Accelerator (≤€2,5M + equity)
+  if jobseeker)        is open; check forrás left)   → needs TRL6 product + company
+ + "saját honlap"      EV closed year COUNTS;         → "only-software" firms may be
+   voucher (0,4–2M)    don't found a fresh Kft and     excluded from VC — verify
+                       reset the closed-year clock
+```
+
+## Canonical sources (check live, frames run "until funds run out")
+
+- **palyazat.gov.hu**, official Széchenyi Terv Plusz portal; the *active list* is the
+  source of truth for open/closed. JS-rendered: status reliable, deep params need the PDF.
+- **nkfih.gov.hu**, innovation & VC calls (GINOP 2.x). Often slow/times out, be patient.
+- **mfb.hu**, the loan programs (GINOP 1.4.x KKV Technológia Hitel).
+- **hiventures.hu**, the early-stage VC fund manager (runs GINOP 2.5.1, ≤€300k).
+- **eic.ec.europa.eu**, EIC Accelerator (deep-tech, ≤€2,5M grant + equity).
+- **ec.europa.eu/info/funding-tenders**, EU Funding & Tenders Portal.
+- Aggregators (palyazatmenedzser, palyaz.hu, eumanagement) are useful for the *active
+  list* but are **paywalled / conflicting** on detail and status, confirm against official.
+
+## Slovakia (SK) sources
+
+The same channels, ladder, and gotchas apply; swap the Hungarian portals for the SK ones:
+
+| Channel | HU | SK equivalent |
+|---|---|---|
+| EU-funds portal (source of truth) | palyazat.gov.hu | **ITMS21+** (`portal.itms21.sk`, `itms2014.sk`) |
+| Operational programme | Széchenyi Terv Plusz | **Program Slovensko 2021-2027** (`eurofondy.gov.sk`) |
+| Cheap loan / digital | MFB, GINOP 1.4.x | **Plán obnovy / VAIA** via SIH (digital, rate cut + up to 30% loan forgiveness) |
+| Early-stage VC | Hiventures | **Venture to Future Fund** (`vff.sk`) via Slovak Investment Holding (EIB + MoF, IT focus) |
+| Micro / SME | KKV grants | **Slovak Business Agency (SBA)** microloans €2,500-50,000; **National Holding Fund** €20k-1.5M (IT) |
+| Innovation / R&D advisory | NKFIH | **SIEA** regional advisory; **APVV / VAIA** R&D grants |
+
+EU-level (EIC, Digital Europe, Horizon) is shared across both countries. Confirm live
+status on the SK portal, the same "funds run out" caveat applies.
+
+## Hard-won gotchas (verified this domain, they bite every time)
+
+- **Closed-year wall.** Most KKV grants/loans (DIMOP 1.2.6, GINOP 1.4.3) require ≥1
+  full closed business year + ≥1 employee. A brand-new company cannot apply day one.
+- **EV counts.** An egyéni vállalkozó's closed tax year *is* a closed business year, and
+  EV is usually an eligible form. Don't throw that history away by founding a fresh Kft.
+- **Region split.** For DIMOP/GINOP the line is Budapest (`/C`) vs. every other county
+  (`/B`, "less developed"), wealthy counties like Győr-Moson-Sopron are in the *favoured*
+  `/B`, but ~65% of some loan frames is ring-fenced for the 4 most-disadvantaged regions.
+- **Timing kills.** Frames close on *forráskimerülés* (funds exhausted), often before the
+  stated deadline. The spring-2026 round closed DIMOP 1.2.6/B, GINOP 1.2.4, 2.1.3, 2.1.4.
+  Always re-check the active list the same day.
+- **VC ≠ free.** Hiventures/EIC take equity and need a TRL6 working product + a company.
+- **"Only software" exclusion.** GINOP 2.5.1 (Hiventures) excludes firms developing *only*
+  immaterial assets (software). A pure SaaS/agent-wrapper play may not qualify, needs a
+  data/hardware/vertical asset beyond code. Verify the exact clause in the call PDF.
+- **Deep-tech ≠ SaaS for EIC.** An LLM-wrapper is SaaS, not deep tech; EIC wants
+  breakthrough + technological risk. Hungary is a "widening" country → EIC **Pre-Accelerator**
+  is the realistic stepping stone before the full Accelerator.
+
+## Research procedure
+
+1. **Classify the ask**, tender / grant / loan / VC (table above). Wrong channel wastes hours.
+2. **Place on the ladder**, how many closed business years? That gates everything.
+3. **Pull the active list**, palyazat.gov.hu (grants/loans) + hiventures.hu / eic (VC).
+   Filter to the company's region and form.
+4. **Confirm status + eligibility** from the official call PDF (not aggregators): open?
+   closed-year requirement? region? amount? intensity? exclusions?
+5. **Rank by fit**, run `/roi-estimator` when listing 3+ options.
+6. **Tag confidence**, amounts/deadlines move weekly; mark unverified figures and name the
+   one thing to confirm by phone (NKFIH / kormányhivatal) before the user acts.
+
+## Rules
+
+- Never quote a grant amount, deadline, or eligibility from memory, it is stale. Fetch live
+  and tag confidence; a "verify at palyazat.gov.hu" beats a confident wrong number.
+- State the channel explicitly every time (grant vs loan vs equity), the user conflates them.
+- Match the portal to the company's country: HU goes to palyazat.gov.hu, SK to ITMS21+ /
+  eurofondy.gov.sk. Don't quote a Hungarian program to a Slovak company or vice versa.
+- Surface the closed-year and region gates *before* detailing amounts; they disqualify fastest.
+- For procurement/tenders, hand off to [[ted-tender-search]]. For deep research sweeps, [[defuddle]].
+
+## Example
+
+User: "I just started a Hungarian IT company. What grants can I apply for?"
+
+Classify (grant, not tender), place on the ladder: 0 closed years means the big KKV
+grants (DIMOP, GINOP) are gated out, so day-one is vállalkozóvá válás (if a jobseeker
+founder) plus the saját-honlap voucher; the real money opens after one closed business
+year. If the company is a scalable AI *product* at TRL6, route to Hiventures (GINOP
+2.5.1, equity), watching the "only software" exclusion. Pull the live active list from
+palyazat.gov.hu, confirm eligibility in the call PDF, and tag every amount's confidence.

package/resources/skills/skills/eu-funding/hu-grant-finder/evals.md

@@ -0,0 +1,26 @@
+# Activation evals — hu-grant-finder
+
+Run by judging each query against the `description:` only: does it fire?
+Pass bar: >=90% of TRIGGER fire, <=10% of NO-TRIGGER false-fire.
+
+## TRIGGER (must fire)
+
+- what grants can my Hungarian company apply for?
+- pályázat IT cégnek
+- GINOP DIMOP support amounts
+- is there funding for a new startup in Hungary?
+- Hiventures venture capital eligibility
+- EIC Accelerator for my AI company
+- támogatás induló vállalkozásnak
+- what EU funding can a Slovak company get?
+
+## NO-TRIGGER (must NOT fire — route elsewhere)
+
+- find EU tenders to bid on              → ted-tender-search
+- search TED notices                     → ted-tender-search
+- write a grant application PDF           → gstack/document-generate
+- scrape palyazat.gov.hu                  → gstack/scrape
+- review my code                         → none
+
+Last run (after EIC re-added, boundary = "not tenders"):
+8/8 trigger, 0/5 false-fire = 100%.

package/resources/skills/skills/eu-funding/ted-tender-search/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: ted-tender-search
+description: 'Use when user says "find EU tenders", "TED search", "public procurement", "közbeszerzés", or wants EU procurement notices by CPV, country, or keyword. Queries the free official TED API (no key).'
+tags: [eu-funding, tenders, procurement, ted, hungary]
+---
+
+# TED tender search
+
+Search live EU public-procurement notices through the **official TED API** (Tenders
+Electronic Daily). Free, no API key, no scraper. This is the canonical source, 
+Apify/Firecrawl and most "TED MCPs" just resell this same data.
+
+- **Endpoint:** `POST https://api.ted.europa.eu/v3/notices/search`
+- **Auth:** none
+- **Notice page:** `https://ted.europa.eu/en/notice/<publication-number>` (e.g. `568232-2025`)
+
+## Run a search (one command)
+
+`scripts/ted-search.sh` builds the query, calls the API, and prints the newest 15
+notices ranked, with buyer + notice URL. Args: buyer country, CPV codes, scope, limit.
+
+```bash
+scripts/ted-search.sh HUN "72000000 48000000 73000000" ACTIVE 50
+```
+
+It prints `TOTAL match: <n>` (the full count, not just the page). For custom filters
+(`place-of-performance`, `FT ~ (...)`) build the body by hand using the fields below;
+the request is `POST https://api.ted.europa.eu/v3/notices/search` with JSON
+`{query, fields, limit, scope}`, `scope` = `ACTIVE` (open) or `ALL` (historical).
+
+## Query language (verified fields)
+
+| Filter | Field | Example |
+|---|---|---|
+| CPV code | `classification-cpv IN (...)` | `classification-cpv IN (72000000 48000000)` |
+| Buyer's country | `organisation-country-buyer IN (...)` | `organisation-country-buyer IN (HUN)` |
+| Where work is performed | `place-of-performance IN (...)` | `place-of-performance IN (HUN SVK)` |
+| Full text (title/summary) | `FT ~ ("..." "...")` | `FT ~ ("artificial intelligence" "mesterséges intelligencia")` |
+
+- Combine with `AND` / `OR`. Country codes are **ISO 3-letter** (`HUN`, `SVK`, `AUT`).
+- `organisation-country-buyer` (who buys) is usually a sharper filter than
+  `place-of-performance` (where work happens), the latter also catches EU-institution
+  contracts that merely touch the country.
+- `FT ~ (...)` searches a narrow title/summary field, expect few hits; it is for
+  pinpointing, not broad discovery.
+
+## CPV codes for IT / AI / software work
+
+| CPV | Domain |
+|---|---|
+| `72000000` | IT services: consulting, software development, internet, support |
+| `48000000` | Software packages and information systems |
+| `73000000` | R&D services |
+
+## Ranking
+
+The API has no relevance sort, so `ted-search.sh` ranks by recency (the publication
+number embeds the year, `NNNNNN-YYYY`) and picks the `eng` then `hun` value from the
+multilingual title/buyer objects (`{"eng":[...], "hun":[...]}`). Edit the script's
+final `python3` filter to sort by a different field.
+
+## Rules
+
+- Always hit the official API first; do not reach for a paid scraper or a TED MCP for
+  search, they wrap this same free endpoint.
+- Use `scope: "ACTIVE"` for biddable tenders; `"ALL"` only to size history.
+- Report `totalNoticeCount`, not just the page you pulled, so the user sees the real universe.
+- Every tender you surface carries its publication number + notice URL. No number, not in the list.
+- A new company rarely wins a tender directly (references/turnover needed), flag the
+  subcontractor route. For *grants/funding* (not procurement), use [[hu-grant-finder]].
+
+## Example
+
+User: "Find open IT tenders from Hungarian buyers."
+
+Query `classification-cpv IN (72000000 48000000 73000000) AND organisation-country-buyer IN (HUN)`
+with `scope: "ACTIVE"`, report `totalNoticeCount`, then list the newest 15 with
+publication number + notice URL. Add `place-of-performance IN (HUN SVK)` to widen to
+Slovakia, or `FT ~ ("artificial intelligence" "mesterséges intelligencia")` to pinpoint
+AI notices.