SkillFind who to talk toPublic data only

Watch SAM.gov contract awards

Turns new federal awards into a short list of accounts with a dated reason to buy, the source link and the role to contact.

Works inClaudeClaude CodeCodexCursorGemini CLIGitHub CopilotChatGPTNeeds: Web searchv1.0 · November 20, 2026
sam-gov-award-watch/SKILL.mdDownload
name
sam-gov-award-watch
description
Use this skill when you sell to companies that win US federal contracts and want a short list of recent SAM.gov award winners that fit your offer, each with what they won, the award date, the source link and the role to contact. Runs on free public data and reports an empty week as empty.
license
CC-BY-4.0

Watch SAM.gov contract awards

This skill turns new US federal award notices on SAM.gov into a short list of accounts with a dated reason to buy. A company that just won federal work has a contract to deliver and a start date to meet, so it is lining up crews, equipment, subcontractors and services now. Run it weekly if you sell to federal contractors, or once before a push into a new agency or region.

Inputs

Ask for what is missing before you search:

  1. What the user sells, in one sentence, and who at a winning company would buy it.
  2. The NAICS codes (up to six digits) or keywords for the work the winners will deliver, not for what the user sells. Ask for up to five.
  3. Place of performance: the states the user can serve.
  4. The window. Default to award notices posted in the last 14 days.
  5. Accounts to leave out: customers, open deals, competitors. A CRM export or a pasted list works.

Steps

  1. Pick the route. With a SAM.gov API key (free, shown on the Account Details page of a SAM.gov account), call https://api.sam.gov/opportunities/v2/search with api_key, postedFrom and postedTo (format MM/dd/yyyy, at most one year apart), ptype=a (award notice), ncode (the NAICS code), limit (up to 1000) and offset (starts at 0). Read the key from the user's settings or an environment variable and never print it. Without a key or without web access, ask the user to open sam.gov, search Contract Opportunities, filter the notice type to Award Notice, and paste or export the results.
  2. Run one query per code and merge the results by notice ID.
  3. Drop schedule paperwork. Many award notices put a company on a GSA schedule rather than award a project. In one search for "surveying" on 17 November 2026, 31 of 40 award matches were GSA Multiple Award Schedule notices. Keep only awards for a defined scope of work.
  4. Read what is being bought. Open each remaining notice. A code or keyword match pulls in unrelated work: the same search returned drone surveillance and janitorial services. Keep a notice only if delivering it plausibly needs what the user sells.
  5. Filter by place of performance to the states the user serves.
  6. Read the dates. Use the award date and, where the notice gives it, the period of performance. An award from the last few weeks is the window. One from months ago reads as a cold pitch, because the purchasing decisions are made.
  7. Remove the accounts to leave out.
  8. Name the role, not a person. At the winner, that is whoever runs or buys for the project, such as the project manager, not the bid team. To find the person, pass the list to the find-the-decision-maker skill if it is installed.
  9. Add history only when asked. USAspending.gov holds award and subaward records with recipients and places of performance. Use it to see who keeps winning in a category, not to find this week's winners.
  10. Report. If nothing survives the filters, say so and show what was searched. An empty week is a valid result.

Output

Return one table, newest award first, then the run note.

| # | Winner | Based in | What they won | Agency | Award date | Amount | Why now | Talk to | Source |
|---|--------|----------|---------------|--------|------------|--------|---------|---------|--------|
| 1 | [Company] | [City, State] | [Scope in plain words] | [Agency, office] | [YYYY-MM-DD] | [$ or "not stated"] | [One line of reasoning tied to the dates] | [Role] | [SAM.gov notice URL] |

Run note: searched NAICS [codes], [states], posted [from] to [to].
[N] award notices returned, [N] dropped as schedule awards, [N] dropped as off-topic,
[N] dropped as excluded accounts, [N] kept.

Write "why now" as reasoning from the notice (award date, scope, place of performance), never as a statistic.

Guardrails

Reads: SAM.gov notices and its public API, USAspending.gov, the exclusion list the user provides. Writes: nothing outside this conversation. Asks before: adding any account to a CRM, contacting anyone, or using an API key.

  • MUST link every row to its SAM.gov notice and show the award date.
  • MUST show the run note, including how many notices were dropped and why.
  • MUST say "not stated" when the notice leaves a field empty.
  • MUST treat the point of contact on a notice as the contracting officer, not a sales prospect.
  • NEVER invent a winner, an amount, a date or a contact.
  • NEVER describe SAM.gov as covering state, county or city buyers. It is federal only.
  • NEVER send, schedule or queue a message.

Sources

Made by ALTARA, the AI sales agent your team texts. More skills: https://www.altaratech.com/store

Use it with