2f55f046b9
* feat: add 12 official Apify skills for web scraping and data extraction Add the complete Apify agent-skills collection as official vendor skills, bringing the total skill count from 954 to 966. New skills: - apify-actor-development: Develop, debug, and deploy Apify Actors - apify-actorization: Convert existing projects into Apify Actors - apify-audience-analysis: Audience demographics across social platforms - apify-brand-reputation-monitoring: Track reviews, ratings, and sentiment - apify-competitor-intelligence: Analyze competitor strategies and pricing - apify-content-analytics: Track engagement metrics and campaign ROI - apify-ecommerce: E-commerce data scraping for pricing intelligence - apify-influencer-discovery: Find and evaluate influencers - apify-lead-generation: B2B/B2C lead generation from multiple platforms - apify-market-research: Market conditions and geographic opportunities - apify-trend-analysis: Discover emerging trends across platforms - apify-ultimate-scraper: Universal AI-powered web scraper Existing skill fixes: - design-orchestration: Add missing description, fix markdown list spacing - multi-agent-brainstorming: Add missing description, fix markdown list spacing Registry and documentation updates: - Update skill count to 966+ across README.md, README.vi.md - Add Apify to official sources in SOURCES.md and all README variants - Register new skills in catalog.json, skills_index.json, bundles.json, aliases.json - Update CATALOG.md category counts (data-ai: 152, infrastructure: 95) Validation script improvements: - Raise description length limit from 200 to 1024 characters - Add empty description validation check - Apply PEP 8 formatting (line length, spacing, trailing whitespace) * refactor: truncate skill descriptions in SKILL.md files and revert description length validation to 200 characters. * feat: Add `apify-ultimate-scraper` to data-ai and move `apify-lead-generation` from business to general categories.
82 lines
2.2 KiB
Markdown
82 lines
2.2 KiB
Markdown
# CLI-Based Actorization
|
|
|
|
For languages without an SDK (Go, Rust, Java, etc.), create a wrapper script that uses the Apify CLI.
|
|
|
|
## Create Wrapper Script
|
|
|
|
Create `start.sh` in project root:
|
|
|
|
```bash
|
|
#!/bin/bash
|
|
set -e
|
|
|
|
# Get input from Apify key-value store
|
|
INPUT=$(apify actor:get-input)
|
|
|
|
# Parse input values (adjust based on your input schema)
|
|
MY_PARAM=$(echo "$INPUT" | jq -r '.myParam // "default"')
|
|
|
|
# Run your application with the input
|
|
./your-application --param "$MY_PARAM"
|
|
|
|
# If your app writes to a file, push it to key-value store
|
|
# apify actor:set-value OUTPUT --contentType application/json < output.json
|
|
|
|
# Or push structured data to dataset
|
|
# apify actor:push-data '{"result": "value"}'
|
|
```
|
|
|
|
## Update Dockerfile
|
|
|
|
Reference the [cli-start template Dockerfile](https://github.com/apify/actor-templates/blob/master/templates/cli-start/Dockerfile) which includes the `ubi` utility for installing binaries from GitHub releases.
|
|
|
|
```dockerfile
|
|
FROM apify/actor-node:20
|
|
|
|
# Install ubi for easy GitHub release installation
|
|
RUN curl --silent --location \
|
|
https://raw.githubusercontent.com/houseabsolute/ubi/master/bootstrap/bootstrap-ubi.sh | sh
|
|
|
|
# Install your CLI tool from GitHub releases (example)
|
|
# RUN ubi --project your-org/your-tool --in /usr/local/bin
|
|
|
|
# Or install apify-cli and jq manually
|
|
RUN npm install -g apify-cli
|
|
RUN apt-get update && apt-get install -y jq
|
|
|
|
# Copy your application
|
|
COPY . .
|
|
|
|
# Build your application if needed
|
|
# RUN ./build.sh
|
|
|
|
# Make start script executable
|
|
RUN chmod +x start.sh
|
|
|
|
# Run the wrapper script
|
|
CMD ["./start.sh"]
|
|
```
|
|
|
|
## Testing CLI-Based Actors
|
|
|
|
For CLI-based actors (shell wrapper scripts), you may need to test the underlying application directly with mock input, as `apify run` requires a Node.js or Python entry point.
|
|
|
|
Test your wrapper script locally:
|
|
|
|
```bash
|
|
# Set up mock input
|
|
export INPUT='{"myParam": "test-value"}'
|
|
|
|
# Run wrapper script
|
|
./start.sh
|
|
```
|
|
|
|
## CLI Commands Reference
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| `apify actor:get-input` | Get input JSON from key-value store |
|
|
| `apify actor:set-value KEY` | Store value in key-value store |
|
|
| `apify actor:push-data JSON` | Push data to dataset |
|
|
| `apify actor:get-value KEY` | Retrieve value from key-value store |
|