n8n-nodes-federal-spending-forensic-api 1.0.0

package/README.md

@@ -0,0 +1,152 @@
+# n8n-nodes-federal-spending-forensic-api
+
+**Forensic Federal Spending Intelligence for n8n**
+
+Uncover the **$195 BILLION USASpending blind spot** with AI-powered forensic analysis. This n8n community node provides access to the Federal Spending Forensic API - the "Bloomberg Gov killer" that exposes contract opportunities competitors don't even know exist.
+
+![Federal Spending Forensic API](https://raw.githubusercontent.com/ai-solutionist/n8n-nodes-federal-spending-forensic-api/main/nodes/FederalSpendingForensic/federalSpendingForensic.svg)
+
+## Why This Node?
+
+The official USASpending API has critical gaps:
+- **49 agencies** don't report properly (GAO-24-106214)
+- **$195 BILLION** COVID spending discrepancy
+- Complex POST requests with aggressive rate limits
+- No built-in forensic analysis
+
+This node solves all of that with:
+- 🎯 **Recompete Radar™** - Find contracts expiring in your industry
+- 🏷️ **Set-Aside Scanner™** - $150B+ in small business opportunities
+- 📈 **Contract Growth Tracker™** - Flag suspicious modification patterns
+- 🏛️ **SAM.gov Integration** - Live RFPs, RFIs, and solicitations
+- 🔍 **FPDS Cross-Reference** - "Dark money" discrepancy detection
+
+## Operations
+
+### Search Contracts
+Query federal contract awards with filters for agency, NAICS, keywords, recipient, and more.
+
+### Recompete Radar
+**Pipeline gold.** Find contracts expiring within your specified window (30-730 days). Perfect for BD teams tracking recompete opportunities.
+
+### Set-Aside Scanner
+Access the **$150B+ small business market**:
+- 8(a) Business Development
+- HUBZone
+- SDVOSB (Service-Disabled Veteran)
+- WOSB/EDWOSB (Women-Owned)
+- Small Disadvantaged Business
+
+### Contract Growth Tracker
+Forensic analysis to find contracts that grew **200%+** from original value - indicators of poor planning, scope creep, or incumbent lock-in.
+
+### SAM.gov Opportunities
+Search live solicitations, RFPs, RFIs, and Sources Sought notices directly from SAM.gov. Requires a free SAM.gov API key.
+
+### Entity Verification
+Verify contractor SAM.gov registration status, check for exclusions/debarments, and validate entity information.
+
+### Agency Profile
+Get agency spending profiles with GAO audit findings and reporting status.
+
+### Forensic Audit
+Full forensic analysis with cross-referencing across multiple data sources.
+
+## Installation
+
+### In n8n (Recommended)
+
+1. Go to **Settings** > **Community Nodes**
+2. Click **Install**
+3. Enter: `n8n-nodes-federal-spending-forensic-api`
+4. Click **Install**
+
+### Manual Installation
+
+```bash
+npm install n8n-nodes-federal-spending-forensic-api
+```
+
+## Credentials
+
+This node requires an **Apify API Token**:
+
+1. Create a free account at [apify.com](https://apify.com)
+2. Go to Settings > Integrations
+3. Copy your API token
+4. Add credentials in n8n: **Apify API**
+
+For SAM.gov features, you'll also need a **SAM.gov API Key**:
+1. Register at [api.sam.gov](https://api.sam.gov)
+2. Request API access
+3. Enter the key in the node parameters
+
+## Example Workflows
+
+### Daily Recompete Alert
+```
+Schedule Trigger → Federal Spending Forensic (Recompete Radar) → IF (urgency = HIGH) → Slack Notification
+```
+
+### Set-Aside Opportunity Pipeline
+```
+Federal Spending Forensic (Set-Aside Scanner) → Airtable/Salesforce → Email Alert
+```
+
+### Contractor Due Diligence
+```
+Webhook → Federal Spending Forensic (Entity Verify) → IF (exclusion) → Alert
+```
+
+## Output Examples
+
+### Contract Search
+```json
+{
+  "awardId": "W911QX24F0053",
+  "recipientName": "PALANTIR USG INC",
+  "awardAmount": 292680000,
+  "awardingAgency": "Department of Defense",
+  "description": "MAVEN SMART SYSTEM",
+  "discrepancyScore": 14,
+  "forensicFlags": [
+    {
+      "type": "late_reporting",
+      "message": "Award data was reported 1580 days after start date"
+    }
+  ]
+}
+```
+
+### Recompete Radar
+```json
+{
+  "awardId": "70RTAC21FC0000006",
+  "recipientName": "CACI NSS, LLC",
+  "awardAmount": 215290000,
+  "daysUntilExpiration": 33,
+  "urgency": "HIGH",
+  "endDate": "2026-03-01"
+}
+```
+
+## Pricing
+
+The underlying Apify actor uses pay-per-result pricing:
+- **$0.03 per result** 
+- First results free (Apify free tier)
+- No Bloomberg Gov subscription ($7,500+/year) required!
+
+## Support
+
+- **Documentation**: [Apify Actor Documentation](https://apify.com/ai_solutionist/federal-spending-forensic-api)
+- **Issues**: [GitHub Issues](https://github.com/ai-solutionist/n8n-nodes-federal-spending-forensic-api/issues)
+- **Author**: Jason Pellerin - [jasonpellerin.com](https://jasonpellerin.com)
+
+## License
+
+MIT
+
+---
+
+*"The official USASpending API has a $195B blind spot. This node uses forensic cross-referencing to find the 'Dark Money' contracts the government forgot to report. Stop fighting for the visible 70%—snatch the 30% that requires forensic extraction."*

package/dist/credentials/ApifyApi.credentials.d.ts

@@ -0,0 +1,8 @@
+import { IAuthenticateGeneric, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ApifyApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+}

package/dist/credentials/ApifyApi.credentials.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApifyApi = void 0;
+class ApifyApi {
+    constructor() {
+        this.name = 'apifyApi';
+        this.displayName = 'Apify API';
+        this.documentationUrl = 'https://docs.apify.com/platform/integrations/api';
+        this.properties = [
+            {
+                displayName: 'API Token',
+                name: 'apiToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                description: 'Your Apify API token from https://console.apify.com/settings/integrations',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '={{"Bearer " + $credentials.apiToken}}',
+                },
+            },
+        };
+    }
+}
+exports.ApifyApi = ApifyApi;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { FederalSpendingForensic } from './nodes/FederalSpendingForensic/FederalSpendingForensic.node';
+import { ApifyApi } from './credentials/ApifyApi.credentials';
+export { FederalSpendingForensic, ApifyApi };

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApifyApi = exports.FederalSpendingForensic = void 0;
+const FederalSpendingForensic_node_1 = require("./nodes/FederalSpendingForensic/FederalSpendingForensic.node");
+Object.defineProperty(exports, "FederalSpendingForensic", { enumerable: true, get: function () { return FederalSpendingForensic_node_1.FederalSpendingForensic; } });
+const ApifyApi_credentials_1 = require("./credentials/ApifyApi.credentials");
+Object.defineProperty(exports, "ApifyApi", { enumerable: true, get: function () { return ApifyApi_credentials_1.ApifyApi; } });

package/dist/nodes/FederalSpendingForensic/FederalSpendingForensic.node.d.ts

@@ -0,0 +1,5 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class FederalSpendingForensic implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/FederalSpendingForensic/FederalSpendingForensic.node.js

@@ -0,0 +1,600 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FederalSpendingForensic = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+class FederalSpendingForensic {
+    constructor() {
+        this.description = {
+            displayName: 'Federal Spending Forensic API',
+            name: 'federalSpendingForensic',
+            icon: 'file:federalSpendingForensic.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Forensic federal spending intelligence - Uncover the $195B USASpending blind spot',
+            defaults: {
+                name: 'Federal Spending Forensic',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'apifyApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                // ==========================================
+                // OPERATION SELECTOR
+                // ==========================================
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Search Contracts',
+                            value: 'contracts',
+                            description: 'Search federal contract awards',
+                            action: 'Search federal contracts',
+                        },
+                        {
+                            name: 'Recompete Radar',
+                            value: 'recompete',
+                            description: 'Find contracts expiring soon (pipeline opportunities)',
+                            action: 'Find recompete opportunities',
+                        },
+                        {
+                            name: 'Set-Aside Scanner',
+                            value: 'setAside',
+                            description: 'Find small business set-aside opportunities',
+                            action: 'Scan set-aside contracts',
+                        },
+                        {
+                            name: 'Contract Growth Tracker',
+                            value: 'contractGrowth',
+                            description: 'Find contracts with suspicious growth patterns',
+                            action: 'Track contract growth anomalies',
+                        },
+                        {
+                            name: 'SAM.gov Opportunities',
+                            value: 'samOpportunities',
+                            description: 'Search live RFPs and solicitations',
+                            action: 'Search SAM gov opportunities',
+                        },
+                        {
+                            name: 'Entity Verification',
+                            value: 'entityVerify',
+                            description: 'Verify contractor SAM.gov registration',
+                            action: 'Verify entity registration',
+                        },
+                        {
+                            name: 'Agency Profile',
+                            value: 'agencies',
+                            description: 'Get agency spending profiles and GAO findings',
+                            action: 'Get agency profile',
+                        },
+                        {
+                            name: 'Forensic Audit',
+                            value: 'forensicAudit',
+                            description: 'Full forensic analysis with cross-referencing',
+                            action: 'Run forensic audit',
+                        },
+                        {
+                            name: 'Get Run Status',
+                            value: 'getStatus',
+                            description: 'Check the status of a running extraction',
+                            action: 'Get run status',
+                        },
+                    ],
+                    default: 'contracts',
+                },
+                // ==========================================
+                // COMMON FILTERS
+                // ==========================================
+                {
+                    displayName: 'Agency',
+                    name: 'agency',
+                    type: 'options',
+                    options: [
+                        { name: 'All Agencies', value: 'all' },
+                        { name: 'Department of Defense', value: 'Department of Defense' },
+                        { name: 'Department of Homeland Security', value: 'Department of Homeland Security' },
+                        { name: 'Department of Health and Human Services', value: 'Department of Health and Human Services' },
+                        { name: 'Department of Veterans Affairs', value: 'Department of Veterans Affairs' },
+                        { name: 'Department of Energy', value: 'Department of Energy' },
+                        { name: 'Department of Justice', value: 'Department of Justice' },
+                        { name: 'Department of Transportation', value: 'Department of Transportation' },
+                        { name: 'National Aeronautics and Space Administration', value: 'National Aeronautics and Space Administration' },
+                        { name: 'General Services Administration', value: 'General Services Administration' },
+                    ],
+                    default: 'all',
+                    displayOptions: {
+                        show: {
+                            operation: ['contracts', 'recompete', 'setAside', 'contractGrowth', 'forensicAudit', 'agencies', 'samOpportunities'],
+                        },
+                    },
+                    description: 'Filter by federal agency',
+                },
+                {
+                    displayName: 'Fiscal Year',
+                    name: 'fiscalYear',
+                    type: 'number',
+                    default: 2024,
+                    typeOptions: {
+                        minValue: 2015,
+                        maxValue: 2026,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['contracts', 'recompete', 'setAside', 'contractGrowth', 'forensicAudit', 'agencies'],
+                        },
+                    },
+                    description: 'Federal fiscal year (October 1 - September 30)',
+                },
+                {
+                    displayName: 'Keywords',
+                    name: 'keywords',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            operation: ['contracts', 'recompete', 'setAside', 'forensicAudit', 'samOpportunities'],
+                        },
+                    },
+                    description: 'Search keywords (comma-separated)',
+                    placeholder: 'cybersecurity, IT services',
+                },
+                {
+                    displayName: 'NAICS Code',
+                    name: 'naicsCode',
+                    type: 'string',
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            operation: ['contracts', 'setAside', 'samOpportunities'],
+                        },
+                    },
+                    description: 'North American Industry Classification Code (e.g., 541512)',
+                    placeholder: '541512',
+                },
+                {
+                    displayName: 'Max Results',
+                    name: 'maxResults',
+                    type: 'number',
+                    default: 50,
+                    typeOptions: {
+                        minValue: 1,
+                        maxValue: 500,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['contracts', 'recompete', 'setAside', 'contractGrowth', 'forensicAudit', 'samOpportunities'],
+                        },
+                    },
+                    description: 'Maximum number of results to return',
+                },
+                // ==========================================
+                // RECOMPETE RADAR OPTIONS
+                // ==========================================
+                {
+                    displayName: 'Expiring Within (Days)',
+                    name: 'expiringWithinDays',
+                    type: 'number',
+                    default: 180,
+                    typeOptions: {
+                        minValue: 30,
+                        maxValue: 730,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['recompete'],
+                        },
+                    },
+                    description: 'Find contracts expiring within this many days',
+                },
+                {
+                    displayName: 'Minimum Award Amount',
+                    name: 'minAwardAmount',
+                    type: 'number',
+                    default: 0,
+                    displayOptions: {
+                        show: {
+                            operation: ['recompete', 'contracts'],
+                        },
+                    },
+                    description: 'Minimum contract value in USD',
+                },
+                // ==========================================
+                // SET-ASIDE SCANNER OPTIONS
+                // ==========================================
+                {
+                    displayName: 'Set-Aside Type',
+                    name: 'setAsideType',
+                    type: 'options',
+                    options: [
+                        { name: 'All Set-Asides', value: 'all' },
+                        { name: '8(a) Business Development', value: '8a' },
+                        { name: 'HUBZone', value: 'hubzone' },
+                        { name: 'SDVOSB (Service-Disabled Veteran)', value: 'sdvosb' },
+                        { name: 'WOSB (Women-Owned)', value: 'wosb' },
+                        { name: 'EDWOSB (Economically Disadvantaged Women)', value: 'edwosb' },
+                        { name: 'Small Business Set-Aside', value: 'small_business' },
+                        { name: 'SDB (Small Disadvantaged Business)', value: 'sdb' },
+                    ],
+                    default: 'all',
+                    displayOptions: {
+                        show: {
+                            operation: ['setAside', 'samOpportunities'],
+                        },
+                    },
+                    description: 'Filter by small business program',
+                },
+                // ==========================================
+                // CONTRACT GROWTH OPTIONS
+                // ==========================================
+                {
+                    displayName: 'Minimum Growth Percentage',
+                    name: 'minGrowthPercent',
+                    type: 'number',
+                    default: 200,
+                    typeOptions: {
+                        minValue: 100,
+                        maxValue: 1000,
+                    },
+                    displayOptions: {
+                        show: {
+                            operation: ['contractGrowth'],
+                        },
+                    },
+                    description: 'Flag contracts that grew by this percentage or more',
+                },
+                // ==========================================
+                // SAM.GOV OPTIONS
+                // ==========================================
+                {
+                    displayName: 'SAM.gov API Key',
+                    name: 'samGovApiKey',
+                    type: 'string',
+                    typeOptions: {
+                        password: true,
+                    },
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            operation: ['samOpportunities', 'entityVerify'],
+                        },
+                    },
+                    description: 'Your SAM.gov API key (get free at api.sam.gov)',
+                },
+                {
+                    displayName: 'Notice Type',
+                    name: 'samNoticeType',
+                    type: 'options',
+                    options: [
+                        { name: 'All Types', value: 'all' },
+                        { name: 'Solicitation (RFP/RFQ)', value: 'o' },
+                        { name: 'Presolicitation', value: 'p' },
+                        { name: 'Combined Synopsis/Solicitation', value: 'k' },
+                        { name: 'Sources Sought / RFI', value: 'r' },
+                        { name: 'Award Notice', value: 'a' },
+                    ],
+                    default: 'all',
+                    displayOptions: {
+                        show: {
+                            operation: ['samOpportunities'],
+                        },
+                    },
+                    description: 'Filter SAM.gov notices by type',
+                },
+                // ==========================================
+                // ENTITY VERIFICATION
+                // ==========================================
+                {
+                    displayName: 'Entity Name or UEI',
+                    name: 'recipientName',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['entityVerify'],
+                        },
+                    },
+                    description: 'Company name or 12-character UEI to verify',
+                    placeholder: 'ACME Corporation or ABC123DEF456',
+                },
+                // ==========================================
+                // GET STATUS
+                // ==========================================
+                {
+                    displayName: 'Run ID',
+                    name: 'runId',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['getStatus'],
+                        },
+                    },
+                    description: 'The ID of the actor run to check',
+                },
+                // ==========================================
+                // ADVANCED OPTIONS
+                // ==========================================
+                {
+                    displayName: 'Wait for Completion',
+                    name: 'waitForCompletion',
+                    type: 'boolean',
+                    default: true,
+                    displayOptions: {
+                        hide: {
+                            operation: ['getStatus'],
+                        },
+                    },
+                    description: 'Whether to wait for extraction to complete',
+                },
+                {
+                    displayName: 'Advanced Options',
+                    name: 'advancedOptions',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    displayOptions: {
+                        hide: {
+                            operation: ['getStatus', 'entityVerify'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Recipient Name',
+                            name: 'recipientName',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by contractor name',
+                        },
+                        {
+                            displayName: 'Recipient State',
+                            name: 'recipientState',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by contractor state (2-letter code)',
+                            placeholder: 'CO',
+                        },
+                        {
+                            displayName: 'Place of Performance State',
+                            name: 'placeOfPerformanceState',
+                            type: 'string',
+                            default: '',
+                            description: 'Filter by work location state',
+                            placeholder: 'CO',
+                        },
+                        {
+                            displayName: 'PSC Code',
+                            name: 'pscCode',
+                            type: 'string',
+                            default: '',
+                            description: 'Product/Service Code filter',
+                        },
+                        {
+                            displayName: 'Enable Forensic Flags',
+                            name: 'enableForensicFlags',
+                            type: 'boolean',
+                            default: true,
+                            description: 'Whether to analyze for discrepancies and anomalies',
+                        },
+                        {
+                            displayName: 'Trace Sub-Awards',
+                            name: 'traceSubAwards',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to extract prime-to-sub contractor relationships',
+                        },
+                        {
+                            displayName: 'Timeout (seconds)',
+                            name: 'timeout',
+                            type: 'number',
+                            default: 300,
+                            description: 'Maximum time to wait for completion',
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const operation = this.getNodeParameter('operation', 0);
+        const credentials = await this.getCredentials('apifyApi');
+        const baseUrl = 'https://api.apify.com/v2';
+        const actorId = 'ai_solutionist~federal-spending-forensic-api';
+        for (let i = 0; i < items.length; i++) {
+            try {
+                if (operation === 'getStatus') {
+                    const runId = this.getNodeParameter('runId', i);
+                    const response = await this.helpers.httpRequest({
+                        method: 'GET',
+                        url: `${baseUrl}/actor-runs/${runId}`,
+                        headers: {
+                            Authorization: `Bearer ${credentials.apiToken}`,
+                        },
+                        json: true,
+                    });
+                    returnData.push({
+                        json: {
+                            runId,
+                            status: response.data.status,
+                            startedAt: response.data.startedAt,
+                            finishedAt: response.data.finishedAt,
+                            datasetId: response.data.defaultDatasetId,
+                            isFinished: ['SUCCEEDED', 'FAILED', 'ABORTED', 'TIMED-OUT'].includes(response.data.status),
+                        },
+                    });
+                    continue;
+                }
+                // Build input payload for actor
+                const waitForCompletion = this.getNodeParameter('waitForCompletion', i);
+                const advancedOptions = this.getNodeParameter('advancedOptions', i, {});
+                const input = {
+                    searchMode: operation,
+                    maxResults: this.getNodeParameter('maxResults', i, 50),
+                    enableForensicFlags: advancedOptions.enableForensicFlags !== false,
+                };
+                // Add common parameters
+                if (['contracts', 'recompete', 'setAside', 'contractGrowth', 'forensicAudit', 'agencies', 'samOpportunities'].includes(operation)) {
+                    const agency = this.getNodeParameter('agency', i, 'all');
+                    if (agency !== 'all') {
+                        input.agency = agency;
+                    }
+                }
+                if (['contracts', 'recompete', 'setAside', 'contractGrowth', 'forensicAudit', 'agencies'].includes(operation)) {
+                    input.fiscalYear = this.getNodeParameter('fiscalYear', i, 2024);
+                }
+                if (['contracts', 'recompete', 'setAside', 'forensicAudit', 'samOpportunities'].includes(operation)) {
+                    const keywords = this.getNodeParameter('keywords', i, '');
+                    if (keywords) {
+                        input.keywords = keywords;
+                    }
+                }
+                if (['contracts', 'setAside', 'samOpportunities'].includes(operation)) {
+                    const naicsCode = this.getNodeParameter('naicsCode', i, '');
+                    if (naicsCode) {
+                        input.naicsCode = naicsCode;
+                    }
+                }
+                // Operation-specific parameters
+                if (operation === 'recompete') {
+                    input.expiringWithinDays = this.getNodeParameter('expiringWithinDays', i, 180);
+                    const minAmount = this.getNodeParameter('minAwardAmount', i, 0);
+                    if (minAmount > 0) {
+                        input.minAwardAmount = minAmount;
+                    }
+                }
+                if (operation === 'setAside' || operation === 'samOpportunities') {
+                    const setAsideType = this.getNodeParameter('setAsideType', i, 'all');
+                    if (setAsideType !== 'all') {
+                        input.setAsideType = setAsideType;
+                    }
+                }
+                if (operation === 'contractGrowth') {
+                    input.minGrowthPercent = this.getNodeParameter('minGrowthPercent', i, 200);
+                }
+                if (operation === 'samOpportunities' || operation === 'entityVerify') {
+                    const samKey = this.getNodeParameter('samGovApiKey', i, '');
+                    if (samKey) {
+                        input.samGovApiKey = samKey;
+                    }
+                }
+                if (operation === 'samOpportunities') {
+                    const noticeType = this.getNodeParameter('samNoticeType', i, 'all');
+                    if (noticeType !== 'all') {
+                        input.samNoticeType = noticeType;
+                    }
+                }
+                if (operation === 'entityVerify') {
+                    input.recipientName = this.getNodeParameter('recipientName', i);
+                }
+                // Add advanced options
+                if (advancedOptions.recipientName) {
+                    input.recipientName = advancedOptions.recipientName;
+                }
+                if (advancedOptions.recipientState) {
+                    input.recipientState = advancedOptions.recipientState;
+                }
+                if (advancedOptions.placeOfPerformanceState) {
+                    input.placeOfPerformanceState = advancedOptions.placeOfPerformanceState;
+                }
+                if (advancedOptions.pscCode) {
+                    input.pscCode = advancedOptions.pscCode;
+                }
+                if (advancedOptions.traceSubAwards) {
+                    input.traceSubAwards = advancedOptions.traceSubAwards;
+                }
+                // Start the actor run
+                const startResponse = await this.helpers.httpRequest({
+                    method: 'POST',
+                    url: `${baseUrl}/acts/${actorId}/runs`,
+                    headers: {
+                        Authorization: `Bearer ${credentials.apiToken}`,
+                        'Content-Type': 'application/json',
+                    },
+                    body: input,
+                    json: true,
+                });
+                const runId = startResponse.data.id;
+                const datasetId = startResponse.data.defaultDatasetId;
+                if (!waitForCompletion) {
+                    returnData.push({
+                        json: {
+                            success: true,
+                            status: 'RUNNING',
+                            runId,
+                            datasetId,
+                            operation,
+                            message: 'Extraction started. Use "Get Run Status" to check progress.',
+                        },
+                    });
+                    continue;
+                }
+                // Poll for completion
+                const timeout = (advancedOptions.timeout || 300) * 1000;
+                const startTime = Date.now();
+                let status = 'RUNNING';
+                while (status === 'RUNNING' && Date.now() - startTime < timeout) {
+                    await new Promise((resolve) => setTimeout(resolve, 5000));
+                    const statusResponse = await this.helpers.httpRequest({
+                        method: 'GET',
+                        url: `${baseUrl}/actor-runs/${runId}`,
+                        headers: {
+                            Authorization: `Bearer ${credentials.apiToken}`,
+                        },
+                        json: true,
+                    });
+                    status = statusResponse.data.status;
+                }
+                if (status !== 'SUCCEEDED') {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Extraction failed with status: ${status}`, { itemIndex: i });
+                }
+                // Fetch results
+                const resultsResponse = await this.helpers.httpRequest({
+                    method: 'GET',
+                    url: `${baseUrl}/datasets/${datasetId}/items`,
+                    headers: {
+                        Authorization: `Bearer ${credentials.apiToken}`,
+                    },
+                    json: true,
+                });
+                const results = Array.isArray(resultsResponse) ? resultsResponse : [resultsResponse];
+                // Return each result as a separate item
+                for (const result of results) {
+                    returnData.push({
+                        json: {
+                            ...result,
+                            _operation: operation,
+                            _runId: runId,
+                            _datasetId: datasetId,
+                        },
+                    });
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    returnData.push({
+                        json: {
+                            error: errorMessage,
+                        },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.FederalSpendingForensic = FederalSpendingForensic;

package/dist/nodes/FederalSpendingForensic/federalSpendingForensic.svg

@@ -0,0 +1,43 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#1a237e;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#0d47a1;stop-opacity:1" />
+    </linearGradient>
+    <linearGradient id="goldGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#ffd700;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#ffb300;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+  
+  <!-- Background circle -->
+  <circle cx="50" cy="50" r="48" fill="url(#bgGrad)" stroke="#0d47a1" stroke-width="2"/>
+  
+  <!-- Capitol building dome -->
+  <path d="M50 18 L50 25 M35 35 Q50 20 65 35 L65 45 L35 45 Z" 
+        fill="white" stroke="white" stroke-width="1"/>
+  
+  <!-- Building columns -->
+  <rect x="30" y="45" width="40" height="25" fill="white"/>
+  <rect x="33" y="48" width="4" height="20" fill="url(#bgGrad)"/>
+  <rect x="40" y="48" width="4" height="20" fill="url(#bgGrad)"/>
+  <rect x="48" y="48" width="4" height="20" fill="url(#bgGrad)"/>
+  <rect x="56" y="48" width="4" height="20" fill="url(#bgGrad)"/>
+  <rect x="63" y="48" width="4" height="20" fill="url(#bgGrad)"/>
+  
+  <!-- Base -->
+  <rect x="25" y="68" width="50" height="5" fill="white"/>
+  
+  <!-- Magnifying glass -->
+  <circle cx="68" cy="68" r="15" fill="none" stroke="url(#goldGrad)" stroke-width="4"/>
+  <line x1="79" y1="79" x2="88" y2="88" stroke="url(#goldGrad)" stroke-width="4" stroke-linecap="round"/>
+  
+  <!-- Dollar sign inside magnifier -->
+  <text x="68" y="73" font-family="Arial, sans-serif" font-size="16" font-weight="bold" 
+        fill="url(#goldGrad)" text-anchor="middle">$</text>
+  
+  <!-- Alert indicator -->
+  <circle cx="78" cy="22" r="10" fill="#f44336"/>
+  <text x="78" y="27" font-family="Arial, sans-serif" font-size="14" font-weight="bold" 
+        fill="white" text-anchor="middle">!</text>
+</svg>

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "n8n-nodes-federal-spending-forensic-api",
+  "version": "1.0.0",
+  "description": "n8n community node for Federal Spending Forensic API - Uncover $195B USASpending blind spot with AI-powered forensic intelligence",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "federal-contracts",
+    "government-spending",
+    "usaspending",
+    "sam-gov",
+    "b2g",
+    "procurement",
+    "forensic",
+    "apify",
+    "recompete",
+    "set-aside",
+    "small-business"
+  ],
+  "license": "MIT",
+  "homepage": "https://jasonpellerin.com",
+  "author": {
+    "name": "Jason Pellerin",
+    "email": "jason@jasonpellerin.com",
+    "url": "https://jasonpellerinfreelance.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ai-solutionist/n8n-nodes-federal-spending-forensic-api.git"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && gulp build:icons",
+    "dev": "tsc --watch",
+    "format": "prettier nodes credentials --write",
+    "lint": "eslint nodes credentials package.json",
+    "lintfix": "eslint nodes credentials package.json --fix",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/ApifyApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/FederalSpendingForensic/FederalSpendingForensic.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.56.0",
+    "gulp": "^4.0.2",
+    "n8n-workflow": "^1.0.0",
+    "prettier": "^3.1.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}