# Roast My Stack (`joeslade/roast-my-stack`) Actor Paste a URL and get a grounded tech-stack roast from Dr. Gordon Pelican. - **URL**: https://apify.com/joeslade/roast-my-stack.md - **Developed by:** [Joe Slade](https://apify.com/joeslade) (community) - **Categories:** Developer tools, AI - **Stats:** 1 total users, 1 monthly users, 0.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Roast My Stack Paste a URL, get roasted. Dr. Gordon Pelican detects the website’s real technology, assigns a transparent stack-health score, delivers a pompous GPT‑5.6 roast, and prescribes grounded security and modernization fixes. He insists on “Dr.” and saves his contempt for technology—not people. ### Try it The production actor is live: - [Open Roast My Stack in Apify](https://console.apify.com/actors/NPZe7pQw8LhEjqc3Y) - Standby endpoint: `https://joeslade--roast-my-stack.apify.actor` Open the actor’s **Standby** tab to use the app; Apify supplies authentication there. Direct requests to a Standby endpoint require an Apify API token: ```bash curl -X POST https://joeslade--roast-my-stack.apify.actor/roast \ -H "Authorization: Bearer $APIFY_TOKEN" \ -H 'content-type: application/json' \ -d '{"url":"https://nextjs.org"}' ```` Enter any public HTTP(S) URL. The result includes: - detected technologies and their risk signals; - a 0–100 score and matching Dr. Pelican mood; - a PG‑13 roast grounded only in detected technology; - three to five prioritized fixes, weighted toward security; and - a public signed share link with a generated social card. ### Sample output ```text Detected: WordPress · jQuery · PHP Score: 46/100 — concerned “WordPress, jQuery, and PHP have assembled a faculty meeting from 2012.” 1. WordPress: lock down extensions — Patch core, themes, and plugins promptly. 2. jQuery: remove legacy dependencies — Reduce aging browser-side attack surface. 3. PHP: stay on a supported release — Apply current runtime security fixes. ``` Model output varies, but every accepted fix must name a technology the detector actually found. ### Run locally Requirements: Node.js 22+, npm, and an OpenAI API key with GPT‑5.6 access. ```bash npm install cp .env.example .env ``` Export the values from `.env` in your shell, then: ```bash npm run build npm start ``` Open `http://localhost:3000`, or call the API: ```bash curl -X POST http://localhost:3000/roast \ -H 'content-type: application/json' \ -d '{"url":"https://example.com"}' ``` Run the validation gates with: ```bash npm test npm run typecheck ``` ### Deploy to Apify This is an Apify SDK v3 Standby actor built by the multi-stage [`.actor/Dockerfile`](.actor/Dockerfile). 1. Install and authenticate the Apify CLI. 2. Store `OPENAI_API_KEY` as a secret Actor environment variable. 3. Keep `ROAST_MODEL=gpt-5.6`. 4. Run `apify push`. The server listens on Apify’s `ACTOR_WEB_SERVER_PORT`. Standby is enabled in the production actor definition only after local tests and the production image build pass. ### How Codex and GPT‑5.6 are used Codex built the application task-by-task from [`docs/plan.md`](docs/plan.md): the clean-room detector and signatures, scoring heuristic, structured roast prompt, HTTP pipeline, pixel UI, share renderer, tests, and Apify packaging. The pre-existing `tech-stack-detector-mcp` is not a dependency and no signature database was imported. GPT‑5.6 performs one job at runtime: it turns the detected stack and deterministic score into Dr. Pelican’s roast plus structured fixes. A strict JSON schema and post-validation drop fixes that do not name detected technology. The default model is `gpt-5.6` (Sol). If OpenAI denies Sol for model-tier permissions, the app makes one retry with `gpt-5.6-terra`; `ROAST_FALLBACK_MODEL` can override that tier. ### Architecture ```text URL → fetch snapshot → original detector → deterministic score → GPT‑5.6 structured roast/fixes → pixel UI + PNG share card ``` The detector currently uses 120 deliberately lean, original, high-signal, roast-worthy rules. Network access is isolated in `src/fetch.ts`. Shared results remain in a bounded in-memory cache for app routes; generated share pages and cards are also written to signed Apify storage URLs so social crawlers can fetch them without receiving an account token. Build notes and the short demo script live in [`docs/eval-log.md`](docs/eval-log.md) and [`docs/demo-script.md`](docs/demo-script.md). ### License [MIT](LICENSE) © 2026 Joe Slade # Actor input Schema ## Actor input object example ```json {} ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("joeslade/roast-my-stack").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 = {} # Run the Actor and wait for it to finish run = client.actor("joeslade/roast-my-stack").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 '{}' | apify call joeslade/roast-my-stack --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=joeslade/roast-my-stack", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Roast My Stack", "description": "Paste a URL and get a grounded tech-stack roast from Dr. Gordon Pelican.", "version": "0.1", "x-build-id": "a5eKzhVPyLlSqGJI6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/joeslade~roast-my-stack/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-joeslade-roast-my-stack", "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/joeslade~roast-my-stack/runs": { "post": { "operationId": "runs-sync-joeslade-roast-my-stack", "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/joeslade~roast-my-stack/run-sync": { "post": { "operationId": "run-sync-joeslade-roast-my-stack", "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": {} }, "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 } } } } } } } } } } ```