# Packagist Composer Package Intelligence Monitor (`automation-lab/packagist-composer-package-intelligence-monitor`) Actor

Monitor Composer package releases, dependency changes, licenses, maintainers, and repository metadata from public Packagist data.

- **URL**: https://apify.com/automation-lab/packagist-composer-package-intelligence-monitor.md
- **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community)
- **Categories:** Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.02 / 1,000 result extracteds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

## Packagist Composer Package Intelligence Monitor

Monitor public Composer package metadata from Packagist.

Track releases, dependency maps, maintainers, licenses, and repository links for exact `vendor/package` names.

### What does it do?

This actor fetches public package metadata from Packagist's P2 registry endpoint.

It produces one structured intelligence record per Composer package.

Use it to capture the latest release and a configurable release history.

### Who is it for?

PHP vendor teams can monitor dependencies used by their applications.

Agencies can review package ecosystems before maintaining client projects.

Supply-chain analysts can export package metadata for scheduled review.

Engineering teams can retain a lightweight release inventory without downloading archives.

### Why use this actor?

Packagist is the canonical public registry for Composer packages.

The actor uses an HTTP JSON endpoint rather than a browser workflow.

That makes runs fast, low-cost, and appropriate for recurring monitoring.

### Data you receive

| Field | Meaning |
| --- | --- |
| `packageName` | Exact Composer vendor/package name |
| `latestVersion` | Most recent Packagist version record |
| `latestReleasedAt` | Release timestamp when available |
| `license` | Declared package licenses |
| `repositoryUrl` | Source repository URL |
| `latestRequire` | Runtime dependency map |
| `latestRequireDev` | Development dependency map |
| `versionHistory` | Recent package release records |

### Quick start

1. Enter one or more exact Composer package names.

2. Choose the release history depth.

3. Start the actor.

4. Export the default dataset as JSON, CSV, Excel, or via the API.

### Input

`packageNames` accepts exact names such as `laravel/framework`.

You can send up to 100 names in one run.

Names that do not match Composer's vendor/package format are skipped.

### Release history depth

Set `maxVersions` from 1 to 100.

The default keeps the 20 newest records per package.

Use a low value for quick release checks.

Use a larger value for an audit-ready historical export.

### Dependency maps

Enable `includeDependencies` to retain `require` and `require-dev` maps.

Dependency counts are always included for quick filtering.

Disable the maps when compact output is more useful than full detail.

### Output

Each dataset item is one package intelligence record.

Nested `versionHistory` entries include release time, version, licenses, and dependency counts.

The actor does not emit a separate row for every version.

This keeps package-level monitoring exports easy to filter and schedule.

### How much does it cost to monitor Packagist Composer packages?

A small start event is charged once per run.

A result event is charged for each package record produced.

Tiered per-result discounts are applied by your Apify plan.

See the actor's Pricing tab for current per-result rates.

### Scheduled monitoring

Schedule this actor daily or weekly for package portfolios.

Export successive datasets to your preferred warehouse or alerting workflow.

Compare `latestVersion`, `latestReleasedAt`, dependency counts, and dependency maps between runs.

### Example package list

```json
{
  "packageNames": ["laravel/framework", "symfony/console"],
  "maxVersions": 20,
  "includeDependencies": true
}
````

### API usage with Node.js

```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/packagist-composer-package-intelligence-monitor').call({
  packageNames: ['laravel/framework'], maxVersions: 10, includeDependencies: true,
});
console.log(await client.dataset(run.defaultDatasetId).listItems());
```

### API usage with Python

```python
from apify_client import ApifyClient
client = ApifyClient("APIFY_TOKEN")
run = client.actor("automation-lab/packagist-composer-package-intelligence-monitor").call(run_input={"packageNames": ["laravel/framework"]})
print(list(client.dataset(run["defaultDatasetId"]).iterate_items()))
```

### API usage with cURL

```bash
curl "https://api.apify.com/v2/acts/automation-lab~packagist-composer-package-intelligence-monitor/runs?token=$APIFY_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"packageNames":["laravel/framework"]}'
```

### Integrations

Send dataset exports to a spreadsheet for vendor reviews.

Use a webhook after scheduled runs to compare versions in your CI or alerting service.

Feed dependency maps into internal software-bill-of-materials workflows.

Use the Apify API to retrieve only new run datasets in a data pipeline.

### MCP

Use this actor through Apify's hosted HTTP MCP transport. The actor-scoped endpoint is:

`https://mcp.apify.com?tools=automation-lab/packagist-composer-package-intelligence-monitor`

Add it in Claude Code:

```bash
claude mcp add --transport http apify-packagist-composer \
  "https://mcp.apify.com?tools=automation-lab/packagist-composer-package-intelligence-monitor"
```

For Claude Desktop, Cursor, or VS Code, add this HTTP MCP configuration:

```json
{
  "mcpServers": {
    "apify-packagist-composer": {
      "type": "http",
      "url": "https://mcp.apify.com?tools=automation-lab/packagist-composer-package-intelligence-monitor"
    }
  }
}
```

Example prompts:

- “Monitor laravel/framework and symfony/console, then summarize their latest releases and dependency counts.”
- “Get the latest five Packagist releases and runtime dependencies for guzzlehttp/guzzle.”
- “Compare Composer release history and licenses for doctrine/orm and monolog/monolog.”

### Tips

Use exact package names copied from Packagist.

Start with two packages to confirm the fields your workflow needs.

Keep `maxVersions` low for routine release checks.

Retain dependency maps for deeper compatibility or supply-chain reviews.

### Error handling

Invalid names and package names not returned by Packagist are skipped.

Other valid packages continue even if one lookup fails.

Check the run log for skipped names and HTTP response details.

### Data source and legality

The actor accesses public metadata returned by Packagist.

Respect Packagist's terms, reasonable request rates, and the licenses of packages you review.

Do not use the output to bypass access controls or redistribute archives.

### FAQ

#### Why is a package missing?

Check that the input uses the exact Composer `vendor/package` name.

Private packages and removed packages are not available from the public P2 endpoint.

#### Why are dependency maps empty?

The package version may not declare dependencies, or `includeDependencies` may be disabled.

#### Does this check security advisories?

No. This actor focuses on public package and release metadata.

Use a dedicated security-advisory workflow for vulnerability assessment.

### Related scrapers

Explore more automation tools at https://apify.com/automation-lab.

This actor complements release-monitoring and software-supply-chain workflows.

### Support

Include the package name and run ID when reporting a problem.

That makes it easier to distinguish invalid names from upstream registry changes.

### Limits

A run accepts up to 100 package names and stores up to 100 history entries per package.

No package archives are downloaded.

No GitHub credentials are required.

### Changelog

See [CHANGELOG](.actor/CHANGELOG.md) for user-visible release notes.

### Summary

Packagist Composer Package Intelligence Monitor turns public Composer registry data into a structured, schedule-ready package monitoring dataset.

# Actor input Schema

## `packageNames` (type: `array`):

Exact vendor/package names to monitor. One output record is created for each package Packagist can resolve.

## `maxVersions` (type: `integer`):

Number of most recent version records to include per package.

## `includeDependencies` (type: `boolean`):

Include require and require-dev maps for the latest version and each requested history entry.

## Actor input object example

```json
{
  "packageNames": [
    "laravel/framework",
    "symfony/console"
  ],
  "maxVersions": 20,
  "includeDependencies": true
}
```

# Actor output Schema

## `overview` (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 = {
    "packageNames": [
        "laravel/framework",
        "symfony/console"
    ],
    "maxVersions": 20,
    "includeDependencies": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("automation-lab/packagist-composer-package-intelligence-monitor").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 = {
    "packageNames": [
        "laravel/framework",
        "symfony/console",
    ],
    "maxVersions": 20,
    "includeDependencies": True,
}

# Run the Actor and wait for it to finish
run = client.actor("automation-lab/packagist-composer-package-intelligence-monitor").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 '{
  "packageNames": [
    "laravel/framework",
    "symfony/console"
  ],
  "maxVersions": 20,
  "includeDependencies": true
}' |
apify call automation-lab/packagist-composer-package-intelligence-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=automation-lab/packagist-composer-package-intelligence-monitor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Packagist Composer Package Intelligence Monitor",
        "description": "Monitor Composer package releases, dependency changes, licenses, maintainers, and repository metadata from public Packagist data.",
        "version": "0.1",
        "x-build-id": "5P7AyrAZI4TTPaUDn"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/automation-lab~packagist-composer-package-intelligence-monitor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-automation-lab-packagist-composer-package-intelligence-monitor",
                "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/automation-lab~packagist-composer-package-intelligence-monitor/runs": {
            "post": {
                "operationId": "runs-sync-automation-lab-packagist-composer-package-intelligence-monitor",
                "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/automation-lab~packagist-composer-package-intelligence-monitor/run-sync": {
            "post": {
                "operationId": "run-sync-automation-lab-packagist-composer-package-intelligence-monitor",
                "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": [
                    "packageNames"
                ],
                "properties": {
                    "packageNames": {
                        "title": "📦 Composer package names",
                        "minItems": 1,
                        "maxItems": 100,
                        "type": "array",
                        "description": "Exact vendor/package names to monitor. One output record is created for each package Packagist can resolve.",
                        "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]*/[A-Za-z0-9][A-Za-z0-9_.-]*$"
                        }
                    },
                    "maxVersions": {
                        "title": "Release history depth",
                        "minimum": 1,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Number of most recent version records to include per package.",
                        "default": 20
                    },
                    "includeDependencies": {
                        "title": "Include dependency maps",
                        "type": "boolean",
                        "description": "Include require and require-dev maps for the latest version and each requested history entry.",
                        "default": true
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```