# GitHub Issue Lead Monitor (`techionik9993/github-issue-lead-monitor`) Actor Find GitHub issues that reveal bugs, feature requests, migration pain, API problems, support demand, competitor gaps, and open-source product signals. - **URL**: https://apify.com/techionik9993/github-issue-lead-monitor.md - **Developed by:** [Techionik](https://apify.com/techionik9993) (community) - **Categories:** AI, MCP servers, Developer tools - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.20 / 1,000 github issue rows 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 ## GitHub Issue Lead Monitor Find GitHub issues that reveal bugs, feature requests, migration pain, API problems, support demand, competitor gaps, and open-source product signals. This Actor is built for developer lead generation, product research, support monitoring, competitive intelligence, and open-source trend tracking. It uses the public GitHub Search API, so runs are fast, low-cost, and do not need a proxy by default. ### What It Returns - GitHub issue title and URL - Repository, issue number, state, labels, and author - Comment count, created time, updated time, and closed time - Source query or source repository - Relevance score and matched source terms - Intent score and matched bug/support/feature keywords - Optional bot-user exclusion - Optional issue body - Monitoring mode for newly discovered issues ### Common Uses - Find people struggling with a product, API, or integration - Monitor open issues for a competitor or ecosystem - Track migration problems after SDK/API changes - Discover feature requests and product gaps - Build developer prospecting lists from public issue data - Watch open-source trends around frameworks, APIs, and tools ### Input Tips Use specific query phrases and repositories. Good query examples: - `stripe webhook error` - `shopify api issue` - `openai api timeout` - `postgres migration error` - `firebase alternative` - `hubspot api bug` Good repository examples: - `vercel/next.js` - `facebook/react` - `openai/openai-node` Use `state = open` for fresh support/lead opportunities. Use `sort = created` for newest issues and `sort = updated` for active monitoring. The default `minimumRelevanceScore` is 2 and `excludeBotUsers` is enabled so the output avoids generic matches and common automation accounts. ### GitHub Token The Actor can work without a token for light public searches, but a GitHub token is recommended for reliable production runs. GitHub's public Search API is rate-limited, and shared cloud IPs may hit that limit quickly. For 500+ result runs, frequent schedules, or many search sources, provide a GitHub token in the hidden `githubToken` input. No proxy is needed. The token is for API rate limits, not bypassing blocks. ### Result Limits `maxResults` is a maximum cap, not a guarantee. The Actor only writes rows that pass your relevance, state, date, and intent filters. Use `maxResultsPerSource` when you provide several queries/repositories and want balanced output. For example, with `maxResults` set to 500 and 5 sources, set `maxResultsPerSource` to 100. Without a GitHub token, keep runs small: one or two focused sources and lower `pagesPerSource`. With a token, larger 500+ result runs are much more reliable. The minimum `maxResults` is 50 so runs are commercially practical and users are charged for meaningful output. ### Monitoring Enable `monitorChanges` to compare the current run against the previous snapshot in the Actor key-value store. When `onlyChanges` is enabled, the dataset contains only newly detected issues. When it is disabled, the dataset contains the current full result set while the change snapshot is still stored for automation. ### Proxy Use No proxy is needed by default. This Actor uses a public API and does not run a browser, which keeps speed high and usage cost low. ### Output Each dataset row represents one GitHub issue. The primary output event is one dataset row. ### Notes This Actor is not affiliated with GitHub. It reads public GitHub Search API results and stores structured rows in your Apify dataset. # Actor input Schema ## `searchQueries` (type: `array`): GitHub issue search phrases. Use product, competitor, error, migration, alternative, or feature-request terms. ## `repositories` (type: `array`): Optional repositories to monitor in owner/repo format. These are queried separately from general searches. ## `state` (type: `string`): Open issues usually contain fresher lead/support opportunities. ## `sort` (type: `string`): Updated is best for monitoring. Created is best for fresh leads. ## `maxResults` (type: `integer`): Maximum rows to write for the whole run. The minimum is 50 for better marketplace economics. ## `maxResultsPerSource` (type: `integer`): Optional cap per query or repository so one source does not fill the entire run. Use 0 for no source cap. ## `pagesPerSource` (type: `integer`): How many GitHub Search API pages to scan per query or repository. Each page requests up to 100 issues. ## `daysBack` (type: `integer`): Only include issues updated or created in the last N days. Use 0 to disable date filtering. ## `includeBody` (type: `boolean`): Include issue body text when available. Disable for faster, lighter output. ## `excludeBotUsers` (type: `boolean`): Skip issues opened by common bot accounts such as renovate[bot] and github-actions[bot]. ## `githubToken` (type: `string`): Recommended for reliable high-volume runs. GitHub's public Search API is rate-limited on shared cloud IPs, so use a token for 500+ result runs. ## `intentKeywords` (type: `array`): Keywords used to score bug, support, lead, and feature-request intent. ## `minimumRelevanceScore` (type: `integer`): Minimum number of meaningful source words that must appear in the issue title, body, repo, or labels. ## `minimumIntentScore` (type: `integer`): Minimum number of intent keywords required. Use 0 for broad research, 1+ for stronger pain/lead signals. ## `monitorChanges` (type: `boolean`): Compare against the previous saved snapshot and detect newly found issues. ## `onlyChanges` (type: `boolean`): When monitoring is enabled, write only newly detected issues to the dataset. ## Actor input object example ```json { "searchQueries": [ "postgres migration error", "firebase alternative", "hubspot api bug" ], "repositories": [ "vercel/next.js", "facebook/react", "openai/openai-node" ], "state": "open", "sort": "updated", "maxResults": 100, "maxResultsPerSource": 0, "pagesPerSource": 3, "daysBack": 365, "includeBody": false, "excludeBotUsers": true, "githubToken": "", "intentKeywords": [ "bug", "error", "alternative", "migration" ], "minimumRelevanceScore": 2, "minimumIntentScore": 0, "monitorChanges": false, "onlyChanges": false } ```` # Actor output Schema ## `results` (type: `string`): Normal runs contain GitHub issue rows. When output-only-changes is enabled, rows contain newly detected issues. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "stripe webhook error", "shopify api issue", "openai api timeout" ] }; // Run the Actor and wait for it to finish const run = await client.actor("techionik9993/github-issue-lead-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": [ "stripe webhook error", "shopify api issue", "openai api timeout", ] } # Run the Actor and wait for it to finish run = client.actor("techionik9993/github-issue-lead-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 '{ "searchQueries": [ "stripe webhook error", "shopify api issue", "openai api timeout" ] }' | apify call techionik9993/github-issue-lead-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=techionik9993/github-issue-lead-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GitHub Issue Lead Monitor", "description": "Find GitHub issues that reveal bugs, feature requests, migration pain, API problems, support demand, competitor gaps, and open-source product signals.", "version": "0.0", "x-build-id": "CoqN7hghgKBuEDvLi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/techionik9993~github-issue-lead-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-techionik9993-github-issue-lead-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/techionik9993~github-issue-lead-monitor/runs": { "post": { "operationId": "runs-sync-techionik9993-github-issue-lead-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/techionik9993~github-issue-lead-monitor/run-sync": { "post": { "operationId": "run-sync-techionik9993-github-issue-lead-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", "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "GitHub issue search phrases. Use product, competitor, error, migration, alternative, or feature-request terms.", "default": [ "stripe webhook error", "shopify api issue", "openai api timeout" ], "items": { "type": "string" } }, "repositories": { "title": "Repositories", "type": "array", "description": "Optional repositories to monitor in owner/repo format. These are queried separately from general searches.", "default": [], "items": { "type": "string" } }, "state": { "title": "Issue state", "enum": [ "open", "closed", "all" ], "type": "string", "description": "Open issues usually contain fresher lead/support opportunities.", "default": "open" }, "sort": { "title": "Sort", "enum": [ "updated", "created", "comments", "reactions" ], "type": "string", "description": "Updated is best for monitoring. Created is best for fresh leads.", "default": "updated" }, "maxResults": { "title": "Max results", "minimum": 50, "maximum": 2000, "type": "integer", "description": "Maximum rows to write for the whole run. The minimum is 50 for better marketplace economics.", "default": 100 }, "maxResultsPerSource": { "title": "Max results per source", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Optional cap per query or repository so one source does not fill the entire run. Use 0 for no source cap.", "default": 0 }, "pagesPerSource": { "title": "Pages per source", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many GitHub Search API pages to scan per query or repository. Each page requests up to 100 issues.", "default": 3 }, "daysBack": { "title": "Days back", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only include issues updated or created in the last N days. Use 0 to disable date filtering.", "default": 365 }, "includeBody": { "title": "Include issue body", "type": "boolean", "description": "Include issue body text when available. Disable for faster, lighter output.", "default": false }, "excludeBotUsers": { "title": "Exclude bot users", "type": "boolean", "description": "Skip issues opened by common bot accounts such as renovate[bot] and github-actions[bot].", "default": true }, "githubToken": { "title": "GitHub token - recommended", "type": "string", "description": "Recommended for reliable high-volume runs. GitHub's public Search API is rate-limited on shared cloud IPs, so use a token for 500+ result runs.", "default": "" }, "intentKeywords": { "title": "Intent keywords", "type": "array", "description": "Keywords used to score bug, support, lead, and feature-request intent.", "default": [ "bug", "error", "issue", "problem", "fail", "broken", "alternative", "feature request", "migration", "timeout", "help" ], "items": { "type": "string" } }, "minimumRelevanceScore": { "title": "Minimum relevance score", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum number of meaningful source words that must appear in the issue title, body, repo, or labels.", "default": 2 }, "minimumIntentScore": { "title": "Minimum intent score", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum number of intent keywords required. Use 0 for broad research, 1+ for stronger pain/lead signals.", "default": 0 }, "monitorChanges": { "title": "Monitor changes since last run", "type": "boolean", "description": "Compare against the previous saved snapshot and detect newly found issues.", "default": false }, "onlyChanges": { "title": "Output only new issues", "type": "boolean", "description": "When monitoring is enabled, write only newly detected issues to the dataset.", "default": false } } }, "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 } } } } } } } } } } ```