GitHub Repo / Maintainer / Company Signal Extractor

Production-ready Apify Actor that resolves public GitHub repositories from orgs, explicit owner/repo references, topics, and free-form repository search queries, then extracts maintainer, company, and commercialization signals into one dataset row per repository.

Features

• Public GitHub data only. No authentication dependency.
• Optional githubToken input or GITHUB_TOKEN environment variable for higher rate limits.
• Resolves repositories from repos, orgs, topics, and searchQueries, deduplicated and capped by maxRepos.
• Extracts repo stats, owner/org data, topics, license, homepage, push timestamps, README links, package names, company/contact/social URLs, and public issue/PR counts when searchable.
• Computes activityScore, maintainerCompanySignalScore, commercializationSignalScore, and concise leadSignals.
• Includes deterministic offline tests and smoke validation using fixture data.

Input

See .actor/input_schema.json for the Apify input schema.

Example:

{
  "orgs": ["acme"],
  "repos": ["openai/example-tool"],
  "topics": ["developer-tools"],
  "searchQueries": ["maintainer automation"],
  "maxRepos": 4,
  "includeReadme": true,
  "includePackageMetadata": true,
  "githubToken": "ghp_optional"
}

Runtime validation requires at least one of orgs, repos, topics, or searchQueries.

Output Schema

Each dataset item contains:

• repoFullName, repoName, repoUrl, description
• owner, ownerType, ownerUrl
• homepage, topics, license, language, defaultBranch
• stars, forks, watchers, openIssuesCount, issueCount, pullRequestCount
• archived, fork, sizeKb, createdAt, updatedAt, pushedAt
• readmeLinks, packageNames
• companyUrls, contactUrls, socialUrls
• activityScore, maintainerCompanySignalScore, commercializationSignalScore
• leadSignals

Sample input: examples/sample-input.json

Sample output: examples/sample-output.json

Usage

Install dependencies:

$npm install

Run locally:

$npm start

Run tests:

$npm test

Run deterministic smoke validation:

$npm run smoke

Rate Limits

The actor uses the public GitHub API and GitHub web-search-accessible counts only. If rate limits are reached, the run fails with a clear message that includes guidance to provide githubToken or GITHUB_TOKEN.

Public Data / Privacy Note

This actor is designed for public GitHub repository metadata and publicly accessible README/package metadata only. Do not use it to process private repositories or secrets. The optional token is used only to authenticate requests against the public GitHub API for higher rate limits.

Publish

Prepare and publish with the Apify CLI when ready:

$apify push