Skip to content

feat: refine template manifesto with use case tags #775

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
DaveHanns merged 3 commits into from
May 20, 2026
+32 −23
Merged

feat: refine template manifesto with use case tags #775

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4731bcd
feat: refine template manifesto with use case tags
DaveHanns May 18, 2026
8a96661
feat: adjust tags
DaveHanns May 18, 2026
66e337f
feat: adjust use case tags
DaveHanns May 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 32 additions & 23 deletions templates/manifest.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,14 +1,22 @@
{
"consoleReadmeSuffixUrl": "https://raw.githubusercontent.com/apify/actor-templates/master/templates/console_readme_suffix.md",
"localReadmeSuffixUrl": "https://raw.githubusercontent.com/apify/actor-templates/master/templates/local_readme_suffix.md",
"_useCaseDescriptions": {
"_note": "Reference for what each value in a template's `useCases` array represents. Templates may carry multiple use cases; pick the tag(s) that reflect what the template actually IS, not what it could become.",
"STARTER": "Entry-level scaffold for a user's first Actor — language quickstarts, empty projects, standby starters, generic wrappers (e.g. cli-start).",
"WEB_SCRAPING": "Extracting structured data from websites — HTTP scrapers, browser scrapers, crawlers. The template's primary output is scraped data.",
"INTEGRATION": "Bridges Apify with external systems — Standby mode (serves HTTP), MCP servers (callable by AI clients), or templates that call out to external APIs, services, or CLIs.",
"AUTOMATION": "Performs actions rather than extracting data — test runners, browser automation (Playwright/Selenium/Cypress used for interaction), CLI orchestration.",
"AI": "LLM-powered agents, AI tool servers (MCP), and AI framework integration demos (LangChain, CrewAI, etc.)."
},
"templates": [
{
"id": "python-crawlee-beautifulsoup",
"name": "python-crawlee-beautifulsoup",
"label": "Crawlee + BeautifulSoup",
"category": "python",
"technologies": ["crawlee", "beautifulsoup"],
"description": "Crawl and scrape websites using Crawlee and BeautifulSoup. Start from a given start URLs, and store results to Apify dataset.",
"description": "Crawl and scrape websites using Crawlee and BeautifulSoup. Start from a URL and store results to your Apify dataset.",
"messages": {
"postCreate": "To install additional Python packages, you need to activate the virtual environment in the \".venv\" folder in the actor directory."
},
Expand All @@ -27,15 +35,15 @@
"name": "python-empty",
"label": "Empty Python project",
"category": "python",
"description": "Empty template with basic structure for the Actor with Apify SDK that allows you to easily add your own functionality.",
"description": "Start with Apify SDK already set up, then build any features you need.",
"archiveUrl": "https://github.com/apify/actor-templates/blob/master/dist/templates/python-empty.zip?raw=true",
"defaultRunOptions": {
"build": "latest",
"memoryMbytes": 1024,
"timeoutSecs": 3600
},
"showcaseFiles": ["my_actor/main.py", "my_actor/__main__.py"],
"useCases": ["WEB_SCRAPING"]
"useCases": ["STARTER"]
},
{
"id": "python-start",
Expand Down Expand Up @@ -93,7 +101,7 @@
"timeoutSecs": 3600
},
"showcaseFiles": ["my_actor/main.py", "my_actor/__main__.py"],
"useCases": ["WEB_SCRAPING"]
"useCases": ["WEB_SCRAPING", "AUTOMATION"]
},
{
"id": "python-selenium",
Expand All @@ -112,14 +120,14 @@
"timeoutSecs": 3600
},
"showcaseFiles": ["my_actor/main.py", "my_actor/__main__.py"],
"useCases": ["WEB_SCRAPING"]
"useCases": ["WEB_SCRAPING", "AUTOMATION"]
},
{
"id": "python-standby",
"name": "python-standby",
"label": "Standby Python project",
"category": "python",
"description": "Template with basic structure for an Actor using Standby mode that allows you to easily add your own functionality.",
"description": "Start with a working Actor in Standby mode that stays ready in the background, then build any features you need.",
"skipTests": true,
"archiveUrl": "https://github.com/apify/actor-templates/blob/master/dist/templates/python-standby.zip?raw=true",
"defaultRunOptions": {
Expand All @@ -128,7 +136,7 @@
"timeoutSecs": 3600
},
"showcaseFiles": ["my_actor/main.py", "my_actor/__main__.py"],
"useCases": ["STARTER"]
"useCases": ["STARTER", "INTEGRATION"]
},
{
"id": "python-scrapy",
Expand Down Expand Up @@ -163,7 +171,7 @@
"label": "Crawlee + Parsel",
"category": "python",
"technologies": ["crawlee", "parsel"],
"description": "Crawl and scrape websites using Crawlee and Parsel. Start from a given start URLs, and store results to Apify dataset.",
"description": "Crawl and scrape websites using Crawlee and Parsel. Start from a URL and store results to your Apify dataset.",
"messages": {
"postCreate": "To install additional Python packages, you need to activate the virtual environment in the \".venv\" folder in the actor directory."
},
Expand All @@ -183,7 +191,7 @@
"label": "Crawlee + Playwright + Chrome",
"category": "python",
"technologies": ["crawlee", "playwright"],
"description": "Crawl and scrape websites using Crawlee and Playwright. Start from a given start URLs, and store results to Apify dataset.",
"description": "Crawl and scrape websites using Crawlee and Playwright. Start from a URL and store results to your Apify dataset.",
"messages": {
"postCreate": "To install additional Python packages, you need to activate the virtual environment in the \".venv\" folder in the actor directory."
},
Expand All @@ -203,7 +211,7 @@
"label": "Crawlee + Playwright + Camoufox",
"category": "python",
"technologies": ["crawlee", "playwright", "camoufox"],
"description": "Crawl and scrape websites using Crawlee and Playwright with Camoufox. Start from a given start URLs, and store results to Apify dataset.",
"description": "Crawl and scrape websites using Crawlee and Playwright with Camoufox. Start from a URL and store results to your Apify dataset.",
"messages": {
"postCreate": "To install additional Python packages, you need to activate the virtual environment in the \".venv\" folder in the actor directory."
},
Expand Down Expand Up @@ -294,7 +302,7 @@
"label": "Smolagents agent",
"category": "python",
"technologies": ["smolagents"],
"description": "An AI news aggregator that fetches and summarizes the latest news based on user-defined interests using DuckDuckGo search and OpenAI models written in Python Smolagents.",
"description": "Create an AI news aggregator that fetches and summarizes the latest news based on your interests, using DuckDuckGo search and OpenAI models with Python Smolagents.",
"archiveUrl": "https://github.com/apify/actor-templates/blob/master/dist/templates/python-pydanticai.zip?raw=true",
"defaultRunOptions": {
"build": "latest",
Expand Down Expand Up @@ -327,7 +335,7 @@
"my_actor/server.py",
"my_actor/__main__.py"
],
"useCases": ["AI"]
"useCases": ["AI", "INTEGRATION"]
},
{
"id": "python-mcp-empty",
Expand All @@ -344,7 +352,7 @@
"timeoutSecs": 60
},
"showcaseFiles": ["my_actor/main.py", "my_actor/__main__.py"],
"useCases": ["AI"]
"useCases": ["AI", "INTEGRATION"]
},
{
"id": "js-crawlee-cheerio",
Expand Down Expand Up @@ -540,7 +548,7 @@
"timeoutSecs": 3600
},
"showcaseFiles": ["src/main.ts", "src/runCodegen.ts", "src/transform.ts"],
"useCases": ["WEB_SCRAPING"]
"useCases": ["AUTOMATION"]
},
{
"id": "ts-empty",
Expand All @@ -556,7 +564,7 @@
"timeoutSecs": 3600
},
"showcaseFiles": ["src/main.ts"],
"useCases": ["WEB_SCRAPING"]
"useCases": ["STARTER"]
},
{
"id": "ts-standby",
Expand All @@ -573,7 +581,7 @@
"timeoutSecs": 3600
},
"showcaseFiles": ["src/main.ts"],
"useCases": ["STARTER"]
"useCases": ["STARTER", "INTEGRATION"]
},
{
"id": "js-cypress",
Expand Down Expand Up @@ -610,7 +618,7 @@
"timeoutSecs": 3600
},
"showcaseFiles": ["src/main.js"],
"useCases": ["WEB_SCRAPING"]
"useCases": ["STARTER"]
},
{
"id": "js-standby",
Expand All @@ -627,15 +635,15 @@
"timeoutSecs": 3600
},
"showcaseFiles": ["src/main.js"],
"useCases": ["STARTER"]
"useCases": ["STARTER", "INTEGRATION"]
},
{
"id": "js-langchain",
"name": "project_langchain_js",
"label": "🦜️🔗 LangChain",
"category": "javascript",
"technologies": ["nodejs", "langchain"],
"description": "Example of how to use LangChain.js with Apify to crawl the web data, vectorize them, and prompt the OpenAI model.",
"description": "Example of how to use LangChain.js with Apify to crawl, vectorize, and query web data with the OpenAI model.",
"archiveUrl": "https://github.com/apify/actor-templates/blob/master/dist/templates/js-langchain.zip?raw=true",
"defaultRunOptions": {
"build": "latest",
Expand Down Expand Up @@ -724,7 +732,7 @@
},
"skipTests": true,
"showcaseFiles": ["src/main.ts", "src/billing.ts"],
"useCases": ["AI"]
"useCases": ["AI", "INTEGRATION"]
},
{
"id": "ts-mcp-empty",
Expand All @@ -741,23 +749,24 @@
},
"skipTests": true,
"showcaseFiles": ["src/main.ts"],
"useCases": ["AI"]
"useCases": ["AI", "INTEGRATION"]
},
{
"id": "cli-start",
"name": "cli-start",
"label": "CLI-based Actor starter",
"category": "javascript",
"technologies": ["jq"],
"description": "Actorize a CLI utility with the Apify Actor CLI",
"description": "Turn any CLI utility into an Apify Actor using the Apify CLI.",
"archiveUrl": "https://github.com/apify/actor-templates/blob/master/dist/templates/cli-start.zip?raw=true",
"defaultRunOptions": {
"build": "latest",
"memoryMbytes": 512,
"timeoutSecs": 600
},
"showcaseFiles": ["main.sh"],
"skipTests": true
"skipTests": true,
"useCases": ["STARTER", "INTEGRATION"]
}
]
}
Loading