# MSP Collective ESP Directory (`tehsnarf/msp-collective-esp-directory`) Actor

Scrapes the MSP Collective's public directory of CMMC/NIST 800-171-certified External Service Providers (ESPs) into normalized JSON rows for defense-industrial-base vendor research and compliance lead generation.

- **URL**: https://apify.com/tehsnarf/msp-collective-esp-directory.md
- **Developed by:** [Chris Hoover](https://apify.com/tehsnarf) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

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/actors/running/actors-in-store.md#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

Scrapes the **[MSP Collective's public ESP directory](https://www.mspcollective.org/esp-directory)** — a curated list of External Service Providers (ESPs) that have achieved CMMC Level 2 / NIST SP 800-171 certification — into clean, structured JSON.

### Why use this Actor?

Defense-industrial-base contractors, prime/sub vendors, and compliance teams routinely need to find and vet managed service providers that already hold CMMC/NIST 800-171 certification before signing them on. This Actor is useful for:

- **Procurement and compliance teams** building a shortlist of CMMC-certified ESPs by headquarters location or certification level.
- **MSPs and ESPs themselves** monitoring their own listing or tracking which competitors are certified and MSP Collective members.
- **Compliance consultancies and researchers** mapping the CMMC-certified vendor market.
- **AI agents and research pipelines** that need machine-readable CMMC/NIST compliance vendor data instead of manually browsing the directory page.

### How to use this Actor

1. Click **Try for free** (or **Run**) on this Actor's page.
2. Leave the default **Start URL** as the MSP Collective ESP directory page.
3. Click **Start** and download your results as JSON, CSV, or Excel from the **Output** tab.

The entire directory is rendered on a single page — there is no pagination to configure, and one run captures the full list.

### Input

| Field | Type | Description |
|---|---|---|
| `startUrls` | array | ESP directory page URL. Defaults to the official page. |
| `maxItems` | integer | Maximum number of ESP records to return (default 100). |
| `delaySeconds` | number | Polite delay before each fetch (default 1.0s). |
| `concurrency` | integer | Reserved for consistency with other Actors in this line; this target is a single static page so it has no effect on run time. |

### Output

Each item represents one certified ESP:

```json
{
  "espDbaName": "Aethon Security",
  "espLegalName": "Aethon Security Consulting, LLC",
  "cmmcL2CertifiedDate": "3/07/2025",
  "websiteUrl": "https://www.aethonsecurity.com/",
  "headquarters": "Middleburg, VA, USA",
  "nist800171Level": "r2",
  "cmmcCertLevel": "L2",
  "mspCollectiveMember": true,
  "sourceUrl": "https://www.mspcollective.org/esp-directory"
}
```

### Data table

| Field | Description |
|---|---|
| espDbaName | ESP's "doing business as" / display name |
| espLegalName | ESP's registered legal entity name |
| cmmcL2CertifiedDate | Date the CMMC Level 2 assessment was certified |
| websiteUrl | ESP's website URL |
| headquarters | HQ city/state/country as published in the directory |
| nist800171Level | NIST 800-171 assessment level (e.g. "r2") |
| cmmcCertLevel | CMMC certification level (e.g. "L2") |
| mspCollectiveMember | `true` if the directory flags the ESP as an MSP Collective member |
| sourceUrl | The directory page URL the record was scraped from |

### Pricing

This Actor is priced at **$2.00 per 1,000 results**. Example costs:

| Results | Cost |
|---|---|
| 100 | $0.20 |
| 500 | $1.00 |
| 1,000 | $2.00 |
| 5,000 | $10.00 |

### Tips

- The directory currently holds 49 ESP records — a single run captures everything in one pass.
- Schedule this Actor on a recurring basis and diff on `espDbaName` to catch newly-certified or newly-listed ESPs without checking the site by hand.

### FAQ

**Is this legal?** Yes — this Actor only reads MSP Collective's public ESP directory page. No login is required, and the site's `robots.txt` does not restrict this page (only HubSpot preview/preference paths are disallowed).

**Does this include personal contact information?** No — every field is company-level (name, certification, location, website). No individual names, emails, or phone numbers are collected.

**Found an issue?** Use the Issues tab on this Actor's Apify Store page to report it.

# Actor input Schema

## `startUrls` (type: `array`):

URLs to scrape (the ESP directory page itself — a single static page, no crawl needed)

## `maxItems` (type: `integer`):

Maximum number of items to scrape

## `delaySeconds` (type: `number`):

Polite delay each fetch waits before requesting

## `concurrency` (type: `integer`):

How many item pages to fetch at once (each still waits delaySeconds before requesting)

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.mspcollective.org/esp-directory"
    }
  ],
  "maxItems": 100,
  "delaySeconds": 1,
  "concurrency": 5
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("tehsnarf/msp-collective-esp-directory").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("tehsnarf/msp-collective-esp-directory").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call tehsnarf/msp-collective-esp-directory --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tehsnarf/msp-collective-esp-directory"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/qQwhXjYbR81ev3UY4/builds/fxCBJ4uYrxn9bM9PX/openapi.json