AI Companies House Intelligence & Monitoring Agent

This Actor provides a professional-grade interface for extracting, analyzing, and monitoring corporate data from the official UK Companies House registry. By integrating the Companies House REST API with Google Gemini-3-Flash AI, the tool transforms raw regulatory filings into structured business intelligence reports.

---

Core Capabilities

1. Multi-Module Data Extraction

The Actor utilizes a modular approach to data retrieval, allowing users to toggle specific data points based on their requirements:

• Company Profile (Standard): Retrieves core registration details, including legal status, incorporation date, SIC classifications, and registered office address.
• Officer & Director Enrichment (Optional): When enabled via the includeOfficers toggle, the Actor fetches a comprehensive list of current and resigned directors, including their roles and appointment dates.
• Beneficial Ownership / PSC (Optional): When enabled via the includePSC toggle, the Actor identifies "Persons with Significant Control," detailing the individuals or entities that exercise ultimate control over the business.

2. Automated Change Detection

The Actor includes a state-persistent monitoring system. By utilizing the Apify Key-Value Store, it compares the unique "Etag" of a company profile against the version stored during the previous execution.

• If a discrepancy is detected, the hasChangedSinceLastRun flag is set to true, and the AI summary is updated to reflect that a profile modification has occurred.
• This feature is designed for automated "Watchlists," allowing users to identify status changes, address moves, or filing updates without manual oversight.

3. AI-Driven Executive Summaries

Data is processed through a strategic intelligence layer powered by Gemini 3 Flash. Each result includes a three-sentence briefing that covers business activity, key figures, and strategic risk flags such as insolvency history or outstanding charges.

---

💰 Fair & Transparent Pricing

While the Apify Store displays a bulk rate per 1,000 results, this Actor operates on a Pay-per-result model with no minimum spend and no monthly commitment.

• Individual Reports: You are charged only $0.40 per company intelligence report generated.
• Minimal Start Cost: The cost to initialize the Actor is near-zero (approx. $0.00005).
• Predictable & Scalable: If you process 10 companies, you spend $4.00. If you process 100, you spend $40.00. You only pay for the value you receive.

Prerequisites

To maintain direct control over data quotas and costs, users must provide their own API credentials:

1. Companies House API Key: Requires a REST/Live key obtained from the Companies House Developer Hub. Note that Companies House enforces a standard rate limit of 600 requests per 5-minute window.
2. Google Gemini API Key: Required for the AI Analysis layer. Keys are obtainable via Google AI Studio.

---

Input Configuration

• Company Numbers: A list of 8-character UK Company Numbers (e.g., 00000006). Note: Numbers with fewer than 8 digits should be prefixed with leading zeros.
• Include Directors/Officers: Boolean toggle to fetch supplemental officer data.
• Include Owners (PSC): Boolean toggle to fetch supplemental ownership and control data.
• API Keys: Secure text fields for Companies House and Gemini credentials.

---

Automation & Webhooks

This Actor is built for seamless integration into your existing business stack. You can automate your intelligence workflow using Webhooks:

1. Setup: After starting a run, navigate to the Integrations tab in the Apify Console.
2. Connect: Add a Webhook URL from Slack, Microsoft Teams, Zapier, or Make.com.
3. Trigger: Set the webhook to trigger on "Run Succeeded".
4. Result: Receive instant, real-time notifications the moment a company change is detected or a report is generated.

---

⚙️ Operational Guidance

For recurring monitoring, it is recommended to use the Schedules tab in the Apify Console. By scheduling the Actor to run daily or weekly, the "Change Detection" system will act as a proactive alert mechanism for your corporate watchlist.

---

Data Output Structure

The Actor produces a refined dataset containing both the AI interpretation and the raw official response:

{
    "companyName": "MARINE AND GENERAL MUTUAL LIFE ASSURANCE SOCIETY",
    "companyNumber": "00000006",
    "status": "dissolved",
    "hasChangedSinceLastRun": true,
    "aiAnalysis": "1. Business Activity: Historic life insurance provider established in 1862. 2. Key Figures: Private unlimited company without share capital. 3. Strategic Insight: Dissolved status and outstanding charges indicate legacy liquidation interests.",
    "details": {
        "profile": { "company_name": "...", "etag": "..." },
        "officers": [ { "name": "...", "role": "..." } ],
        "psc": [ { "name": "...", "nature_of_control": "..." } ]
    }

}