# GovCon FAR/DFARS Clause & Flow-Down Extractor (`jadelike_zine/govcon-far-dfars-clause-extractor`) Actor Extract FAR/DFARS clauses from a US government contract or RFP: each clause's official title, subcontractor flow-down status, plus delivery milestones, penalties and option periods — every field backed by a verbatim source quote. Adds flow-down gap analysis vs your subcontract. - **URL**: https://apify.com/jadelike\_zine/govcon-far-dfars-clause-extractor.md - **Developed by:** [Derrick](https://apify.com/jadelike_zine) (community) - **Categories:** Agents, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $250.00 / 1,000 document clauses extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## GovCon FAR/DFARS Clause & Flow-Down Extractor **What it does (for agents & pipelines):** give it US government contract / RFP text (or a public URL/PDF) and it returns structured JSON of every FAR/DFARS clause, each clause's official title and subcontractor flow-down status, plus delivery milestones, penalties and option periods — every field backed by a verbatim source quote. Machine-readable, pay-per-document, no seat license. Returns, as structured JSON: - ✅ **Every FAR/DFARS clause** the document incorporates or references, each with its **official title** and **subcontractor flow-down status** — `mandatory`, `conditional` (with the trigger), `not_required`, or `prime_only` - ✅ A ready **`flow_down_required` list** — the clause numbers you must (or may need to) push down to subcontracts, for a fast bid/subcontract check - ✅ **Delivery milestones**, **penalties** (liquidated damages / termination for default / cure notices / withholding), and **option periods** - ✅ Every field backed by a **verbatim `source_quote`** from your document — nothing invented Built for **subcontractors and GovCon consultants** who need to know, in seconds, which clauses flow down and what the key terms are. ### What makes it stronger than a clause list Most tools stop at "here are the clauses." This one adds the two things a subcontractor actually needs: 1. **Flow-down GAP analysis** — pass the prime contract **and** the subcontract you received, and it tells you which clauses the prime is *required* to flow down (per FAR 52.244-6) but that are **missing** from your subcontract — a ready compliance-gap / negotiation list, high-severity for mandatory clauses. Competitors extract clauses; this one finds what's *absent*. 2. **Obligation summary (so-what)** — for high-burden clauses it says, in a line, what the clause actually requires you to do (e.g., 252.204-7012 → "implement NIST SP 800-171, report cyber incidents within 72 hours"). Not just a title — the action. ### Why the flow-down status is trustworthy The model only extracts **clause numbers and verbatim quotes** from your text. It never writes clause titles or decides flow-down. A **deterministic reference table** (`rules/far-clauses.json`) then supplies the official title and flow-down status. The core of that table is **FAR 52.244-6(c)(1)** — the authoritative list of clauses a prime must flow down to commercial subcontracts — plus common prime clauses and standard DFARS clauses. A clause **not** in the table comes back as `flow_down: "unknown"` (never guessed), so you always know what was authoritatively resolved vs. what to verify at [acquisition.gov](https://www.acquisition.gov/). ### Input ```json { "documents": [ { "id": "sol-1", "text": "SECTION I - CONTRACT CLAUSES. 52.204-25 ...; 52.219-8 ...; The Contractor shall flow down 52.204-25 to all subcontracts. Delivery within 180 days ..." }, { "id": "sol-2", "url": "https://example.com/public-contract.pdf" } ] } ``` 1–20 documents per run. Provide `text` (paste the clause section — fastest and most reliable) **or** a `url` to a public contract/RFP page or PDF (fetched best-effort). Do **not** point `url` at sam.gov — its [Terms of Use](https://sam.gov/about/terms-of-use) prohibit automated harvesting; paste the text instead. ### Output (per document) ```json { "contract_meta": { "solicitation_or_contract_no": "W912DY-26-R-0042", "agency": "Department of the Army", "is_commercial": true }, "clauses": [ { "clause_number": "52.204-25", "title": "Prohibition on Contracting for Certain Telecommunications and Video Surveillance Services or Equipment (Section 889)", "regime": "FAR", "known": true, "flow_down": "mandatory", "context": "flow_down", "source_quote": "flow down FAR 52.204-25, 52.222-26, and 52.222-50 to all subcontracts" }, { "clause_number": "52.219-8", "title": "Utilization of Small Business Concerns", "regime": "FAR", "known": true, "flow_down": "conditional", "flow_down_condition": "if the subcontract offers further subcontracting opportunities and ... exceeds the FAR 19.702(a) threshold", "source_quote": "FAR 52.219-8 Utilization of Small Business Concerns" } ], "flow_down_required": ["52.204-25", "52.219-8", "52.222-26"], "penalties": [{ "kind": "default-termination", "source_quote": "terminate for default under FAR 52.249-8" }], "option_periods": [{ "duration": "P12M", "source_quote": "up to two 12-month option periods" }], "disclaimer": "..." } ``` ### vs. FARclause.com / VisibleThread / SamSearch Web tools like [FARclause.com](https://farclause.com/) and [VisibleThread](https://www.visiblethread.com/) already extract FAR clauses and analyze flow-downs — and they're good. This Actor is the **API/batch** version of that job: run it over many documents at once, **pay per document** on the Apify marketplace instead of a seat subscription, and drop the structured output (with verbatim quotes) straight into an **agent or data pipeline**. If you want a polished single-document web UI with clause versions/alternates and generated flow-down packages, use FARclause.com. If you want machine-readable clause + flow-down extraction you can automate, use this. ### Limits (read this) - **NOT legal advice** and not a compliance determination. Flow-down applicability depends on subcontract type, dollar thresholds, and tier — the `conditional` triggers are summarized, not evaluated for your specific subcontract. Verify each clause against the current text at acquisition.gov and with a contracts attorney. - The reference table is a **curated snapshot** (v0.1, FAR 52.244-6(c)(1) core + common clauses + a standard DFARS subset). It is **not** the entire FAR/DFARS; clauses outside it return `flow_down: "unknown"`. Agency supplements (GSAR, AFARS, etc.) are out of scope in v1 and are intentionally not mis-parsed as FAR clauses. - Extraction is **text-only** and depends on document quality. Garbage in → low `quote_hit_ratio` → not billed. ### Fair charging Pay per successfully processed document (`clauses-extracted`). Failed fetches, non-contract text, low-verification extractions, and documents skipped after your run's charge limit is reached are **not charged**. Every `source_quote` is re-verified verbatim against the document before the run is billable. ### Development ```bash pnpm install pnpm typecheck # tsc --noEmit pnpm test # vitest: table invariants, validate layer, match/enrichment pnpm smoke # offline end-to-end (no network, no LLM) pnpm golden # real-LLM acceptance vs hand-labeled contract samples (needs DEEPSEEK_API_KEY) ``` Architecture (single-direction deps): `main → fetch/extract/match/validate → rules → domain`. Same three-layer engine as the tender-deep-extractor; the clause reference table is the moat. # Actor input Schema ## `documents` (type: `array`): 1-20 documents. Each item: `text` to paste contract clause text (e.g. the Section I clause list) OR `url` to a public contract/RFP page or PDF (fetched best-effort). Optional `id` is echoed back. OPTIONAL flow-down gap analysis: also include `subcontract_text` (or `subcontract_url`) with the subcontract you received — the output then adds `flow_down_gaps`, the clauses the prime must flow down but that are missing from your subcontract. Do NOT point any url at sam.gov — its Terms of Use prohibit automated harvesting; paste the text instead. ## Actor input object example ```json { "documents": [ { "id": "sample-clauses", "text": "SECTION I - CONTRACT CLAUSES. The following FAR clauses are incorporated by reference: 52.212-4 Contract Terms and Conditions-Commercial Products and Commercial Services (Nov 2023); 52.204-25 Prohibition on Contracting for Certain Telecommunications and Video Surveillance Services or Equipment (Nov 2021); 52.219-8 Utilization of Small Business Concerns (Jan 2025); 52.222-26 Equal Opportunity (Sept 2016). The Contractor shall flow down 52.204-25 and 52.222-26 to all subcontracts. Delivery shall be completed within 180 days after award. The Government may exercise up to three 12-month option periods under 52.217-9." }, { "id": "sample-gap-analysis", "text": "PRIME CONTRACT. Flowed down to all subcontracts: DFARS 252.204-7012 Safeguarding Covered Defense Information; FAR 52.204-25; FAR 52.222-26 Equal Opportunity.", "subcontract_text": "SUBCONTRACT. Incorporated clauses: FAR 52.222-26 Equal Opportunity; FAR 52.212-4." } ] } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "documents": [ { "id": "sample-clauses", "text": "SECTION I - CONTRACT CLAUSES. The following FAR clauses are incorporated by reference: 52.212-4 Contract Terms and Conditions-Commercial Products and Commercial Services (Nov 2023); 52.204-25 Prohibition on Contracting for Certain Telecommunications and Video Surveillance Services or Equipment (Nov 2021); 52.219-8 Utilization of Small Business Concerns (Jan 2025); 52.222-26 Equal Opportunity (Sept 2016). The Contractor shall flow down 52.204-25 and 52.222-26 to all subcontracts. Delivery shall be completed within 180 days after award. The Government may exercise up to three 12-month option periods under 52.217-9." }, { "id": "sample-gap-analysis", "text": "PRIME CONTRACT. Flowed down to all subcontracts: DFARS 252.204-7012 Safeguarding Covered Defense Information; FAR 52.204-25; FAR 52.222-26 Equal Opportunity.", "subcontract_text": "SUBCONTRACT. Incorporated clauses: FAR 52.222-26 Equal Opportunity; FAR 52.212-4." } ] }; // Run the Actor and wait for it to finish const run = await client.actor("jadelike_zine/govcon-far-dfars-clause-extractor").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "documents": [ { "id": "sample-clauses", "text": "SECTION I - CONTRACT CLAUSES. The following FAR clauses are incorporated by reference: 52.212-4 Contract Terms and Conditions-Commercial Products and Commercial Services (Nov 2023); 52.204-25 Prohibition on Contracting for Certain Telecommunications and Video Surveillance Services or Equipment (Nov 2021); 52.219-8 Utilization of Small Business Concerns (Jan 2025); 52.222-26 Equal Opportunity (Sept 2016). The Contractor shall flow down 52.204-25 and 52.222-26 to all subcontracts. Delivery shall be completed within 180 days after award. The Government may exercise up to three 12-month option periods under 52.217-9.", }, { "id": "sample-gap-analysis", "text": "PRIME CONTRACT. Flowed down to all subcontracts: DFARS 252.204-7012 Safeguarding Covered Defense Information; FAR 52.204-25; FAR 52.222-26 Equal Opportunity.", "subcontract_text": "SUBCONTRACT. Incorporated clauses: FAR 52.222-26 Equal Opportunity; FAR 52.212-4.", }, ] } # Run the Actor and wait for it to finish run = client.actor("jadelike_zine/govcon-far-dfars-clause-extractor").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "documents": [ { "id": "sample-clauses", "text": "SECTION I - CONTRACT CLAUSES. The following FAR clauses are incorporated by reference: 52.212-4 Contract Terms and Conditions-Commercial Products and Commercial Services (Nov 2023); 52.204-25 Prohibition on Contracting for Certain Telecommunications and Video Surveillance Services or Equipment (Nov 2021); 52.219-8 Utilization of Small Business Concerns (Jan 2025); 52.222-26 Equal Opportunity (Sept 2016). The Contractor shall flow down 52.204-25 and 52.222-26 to all subcontracts. Delivery shall be completed within 180 days after award. The Government may exercise up to three 12-month option periods under 52.217-9." }, { "id": "sample-gap-analysis", "text": "PRIME CONTRACT. Flowed down to all subcontracts: DFARS 252.204-7012 Safeguarding Covered Defense Information; FAR 52.204-25; FAR 52.222-26 Equal Opportunity.", "subcontract_text": "SUBCONTRACT. Incorporated clauses: FAR 52.222-26 Equal Opportunity; FAR 52.212-4." } ] }' | apify call jadelike_zine/govcon-far-dfars-clause-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jadelike_zine/govcon-far-dfars-clause-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GovCon FAR/DFARS Clause & Flow-Down Extractor", "description": "Extract FAR/DFARS clauses from a US government contract or RFP: each clause's official title, subcontractor flow-down status, plus delivery milestones, penalties and option periods — every field backed by a verbatim source quote. Adds flow-down gap analysis vs your subcontract.", "version": "0.1", "x-build-id": "S34PhnYW7GCHNjirY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jadelike_zine~govcon-far-dfars-clause-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jadelike_zine-govcon-far-dfars-clause-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jadelike_zine~govcon-far-dfars-clause-extractor/runs": { "post": { "operationId": "runs-sync-jadelike_zine-govcon-far-dfars-clause-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jadelike_zine~govcon-far-dfars-clause-extractor/run-sync": { "post": { "operationId": "run-sync-jadelike_zine-govcon-far-dfars-clause-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "documents" ], "properties": { "documents": { "title": "Contract / RFP documents", "minItems": 1, "maxItems": 20, "type": "array", "description": "1-20 documents. Each item: `text` to paste contract clause text (e.g. the Section I clause list) OR `url` to a public contract/RFP page or PDF (fetched best-effort). Optional `id` is echoed back. OPTIONAL flow-down gap analysis: also include `subcontract_text` (or `subcontract_url`) with the subcontract you received — the output then adds `flow_down_gaps`, the clauses the prime must flow down but that are missing from your subcontract. Do NOT point any url at sam.gov — its Terms of Use prohibit automated harvesting; paste the text instead." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```