69 Commits

Author SHA1 Message Date
Dusan Vystrcil b68e575292 docs: add npx skills install command to README
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-28 18:05:30 +01:00
Dušan Vystrčil b66c2feca1 Merge pull request #10 from apify/dev
chore: remove .DS_Store and hooks from git tracking
2026-01-28 08:26:03 +01:00
Dusan Vystrcil 9a51907401 chore: remove .DS_Store and hooks from git tracking
- Remove .DS_Store file from repository
- Remove scripts/hooks/pre_commit_bump.sh (already in .gitignore)
- Add .DS_Store to .gitignore

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-28 08:14:56 +01:00
Dušan Vystrčil c5215ff52c Merge pull request #8 from apify/clarify-apify-run-command
Clarify apify run usage and replace templates with CLI commands
2026-01-27 15:44:31 +01:00
Dušan Vystrčil c96fff6447 Merge pull request #9 from apify/dev
feat: add apify-ultimate-scraper and modernize all skills
2026-01-27 15:43:37 +01:00
Dusan Vystrcil b21b18aef0 chore: regenerate AGENTS.md and README.md
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 15:39:39 +01:00
Dusan Vystrcil 3a9418b59c docs: update example skill and improve validation
- Update README example to showcase apify-ultimate-scraper instead of apify-lead-generation
- Improve marketplace.json validation to skip command-only plugins that don't have skills field
- Fix trailing newline in generate_agents.py

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 15:37:37 +01:00
Dušan Vystrčil ec22ee3751 fix { 2026-01-27 15:32:32 +01:00
Dušan Vystrčil 9acde3e4fc Merge branch 'main' into dev 2026-01-27 15:27:44 +01:00
Dusan Vystrcil 4c8280eddf feat: add Apify Store search command to ultimate-scraper
Add mcpc search-actors command as fallback for discovering Actors not in the
curated 55-Actor list. Users can now search the full Apify Store directly when
no suitable Actor is found. Bump skill 1.2.0 → 1.3.0, marketplace 1.4.0 → 1.5.0,
and plugin 1.4.0 → 1.5.0.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 14:58:43 +01:00
Dusan Vystrcil b3c878d4dd feat: add apify-ultimate-scraper unified skill
Consolidate all 8 existing Apify skills (55 Actors) into a single AI-driven
universal scraper supporting Instagram, Facebook, TikTok, YouTube, Google Maps,
Google Search, Google Trends, Booking.com, and TripAdvisor. Includes Actor
selection by platform and use case, multi-actor workflow examples, and
suggested follow-up actions.

Bump marketplace version 1.2.11 → 1.3.0, plugin version 1.2.9 → 1.3.0, and
new skill version 1.0.0 → 1.1.0 (minor bump for new feature).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 14:49:53 +01:00
Dusan Vystrcil 02f0a948b7 refactor: simplify all skills to use mcpc and JavaScript
- Rewrite 7 SKILL.md files to use mcpc for dynamic schema fetching
- Replace Python run_actor.py with JavaScript run_actor.js
- Delete all reference actor markdown files (now fetched via mcpc)
- Delete workflows.md files
- Update README prerequisites

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 14:23:35 +01:00
Dusan Vystrcil cac2f2a6e7 docs: consolidate apify-lead-generation reference documentation
Replace individual actor reference files and workflows documentation with a single examples.md file that demonstrates common use cases. This consolidation reduces redundancy while maintaining comprehensive guidance.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 14:00:41 +01:00
Dusan Vystrcil d64b7502ce chore: bump versions for JavaScript rewrite
- marketplace.json: 1.2.8 → 1.2.9
- apify-lead-generation: 1.1.8 → 1.1.9
- plugin.json: 1.2.6 → 1.2.7
- run_actor.js USER_AGENT: 1.1.6 → 1.1.9

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 13:31:57 +01:00
Dusan Vystrcil 25c030a8e1 refactor: rewrite run_actor.py to JavaScript with Node.js
Replace Python script with JavaScript implementation using Node.js 20.6+ native features (fetch, --env-file). All 20 command references updated across documentation. Maintains feature parity: CLI parsing, Apify API calls, polling, JSON/CSV output, quick answer mode, User-Agent tracking, and error handling.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 13:29:38 +01:00
Dusan Vystrcil 81e1d9d596 docs: simplify apify-lead-generation workflow and reduce redundancy
Streamline the skill documentation by:
- Remove error handling table, keep inline error references
- Remove detailed "Quick Examples" section (covered in step 4)
- Remove workflow reference link to workflows.md
- Simplify step 3 options: clarify "top few results" and ask about result count
- Clarify what mcpc returns: add actor README, simplify field descriptions
- Add note that prerequisites don't need upfront checking
- Simplify step 5 summary reporting

Makes the skill more concise and focused on core workflow.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 13:01:43 +01:00
Dusan Vystrcil e832baf117 docs: use mcpc to fetch actor schemas dynamically
Replace hardcoded actor reference documentation with dynamic mcpc calls
to fetch live actor details from Apify. This keeps information always
up-to-date without manual doc maintenance.

Changes:
- Add mcpc CLI tool as prerequisite
- Replace step 2 with dynamic schema fetching via mcpc
- Remove static reference doc links from actor table
- Simplify table to show only actor ID and use case

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 12:46:46 +01:00
Dusan Vystrcil fe408e8021 refactor: remove basic fields feature from apify-lead-generation
Remove the --fields basic option and essential fields functionality:
- Delete ESSENTIAL_FIELDS dict from run_actor.py
- Remove --fields argument and related filtering code
- Remove get_nested_value() and filter_fields() helper functions
- Remove "Essential Fields" sections from all 18 actor documentation files
- Simplify SKILL.md examples to show only full data exports

The feature was not being used and adds unnecessary complexity.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 12:33:55 +01:00
Dusan Vystrcil 1a06d8eb82 revert: restore reference-based actor docs in apify-lead-generation 2026-01-27 12:07:06 +01:00
Dusan Vystrcil 0f9730f247 fix: improve PreToolUse hook for automatic version bumping 2026-01-27 11:20:37 +01:00
Dusan Vystrcil 4b70f51714 docs: revert guidance on missing output fields in apify-lead-generation
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 11:04:45 +01:00
Dusan Vystrcil 5f6f7e87af docs: add guidance on handling missing output fields in apify-lead-generation
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 11:03:19 +01:00
Dusan Vystrcil 042bded856 docs: remove extra blank line in apify-lead-generation skill
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 11:01:18 +01:00
Dusan Vystrcil c93d1d6bf8 fix: replace git hook with Claude Code PreToolUse hook
Git hooks can't stage files during commit (index lock). Using Claude Code
PreToolUse hook instead - runs before the bash command executes.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 11:00:32 +01:00
Dusan Vystrcil 30c96bdee8 chore: add git hook for automatic version bumping
Adds a commit-msg hook that automatically runs version bump script
before commits are finalized. Removes manual version bumping requirement
and ensures version files are always staged with commits.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 10:48:35 +01:00
Dusan Vystrcil 0615a74fc4 fix: correct mcpc command syntax in apify-lead-generation skill
- Fix mcpc command to include authentication header and --json flag
- Update fetch-actor-details command to pipe through jq for content extraction
- Update documentation with improved step descriptions and output format options
- Reorganize actor reference structure with gotchas documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 10:16:43 +01:00
patrikbraborec f0720a1a79 Clarify apify run usage and replace templates with CLI commands
- Add explicit warnings about using `apify run` instead of npm/npx commands
- Replace template markdown files with CLI commands in Template Selection
- Add to Do/Don't sections: use `apify run`, not `npm start` or `npx apify run`
- Remove actor-template-js.md, actor-template-python.md, actor-template-ts.md

Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
2026-01-22 13:15:24 +01:00
Dušan Vystrčil 6360760436 Merge pull request #6 from apify/actor-development-skill
Actor development skill
2026-01-21 18:26:05 +01:00
patrikbraborec c5f9628e05 Fix validation to skip commands-only plugins
Updated marketplace.json validation to skip plugins that don't have
a "skills" property (e.g., commands-only plugins). This fixes the CI
error where apify-actor-commands plugin was incorrectly flagged for
missing SKILL.md.

Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
2026-01-21 15:19:41 +01:00
patrikbraborec e4323da0f0 Update generatedBy instructions to include tool and model
Changed instructions to specify both the tool name and model name in the generatedBy property (e.g., "Claude Code with Claude Sonnet 4.5") instead of just the model name. This helps Apify better monitor and improve documentation for specific AI tools and models.

Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
2026-01-21 15:16:00 +01:00
Dusan Vystrcil 056ffbe182 fix: update ESSENTIAL_FIELDS to match actual Actor output schemas
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 14:50:46 +01:00
Dusan Vystrcil 5d33aeb1a6 fix: update voyager-booking-scraper schema across all skills
Correct input parameters for sortBy and propertyType fields, add missing
parameters (startUrls, flexWindow, starsCountFilter, minMaxPrice), and
update currency/language enums with complete values from actual Actor schema.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 13:43:31 +01:00
Dusan Vystrcil 84e6474771 feat: add apify-audience-analysis and apify-content-analytics skills with 18 and 17 actors
- Add audience-analysis skill for understanding audience demographics, preferences, and engagement patterns across Facebook, Instagram, YouTube, and TikTok
- Add content-analytics skill for tracking engagement metrics and measuring content ROI
- Include 7 multi-step workflows for each skill covering key use cases
- Implement run_actor.py scripts with ESSENTIAL_FIELDS for efficient data filtering
- Update marketplace.json and auto-generate AGENTS.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 13:24:24 +01:00
Dusan Vystrcil 5d5b2d9cde feat: add apify-trend-analysis skill with 19 actors
Discover and track emerging trends across Google Trends, Instagram,
Facebook, YouTube, and TikTok to inform content strategy.

Actors included:
- Google Trends: apify/google-trends-scraper
- Instagram: 8 actors for hashtags, posts, search, and API access
- Facebook: 3 actors for marketplace, photos, and groups
- YouTube: 2 actors for Shorts and hashtag videos (streamers)
- TikTok: 6 actors for hashtags, sounds, ads, discover, explore, trends (clockworks)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 12:58:56 +01:00
Dusan Vystrcil 1867370866 feat: add apify-influencer-discovery skill with 15 actors
Discover and analyze influencers across Instagram, Facebook, YouTube, and TikTok for brand partnerships and collaboration evaluation.

- Added 15 actor schemas (8 Instagram, 3 Facebook, 1 YouTube, 3 TikTok)
- Created SKILL.md with actor selection guide and example workflows
- Implemented run_actor.py with merged ESSENTIAL_FIELDS from all platforms
- Added advanced workflows for multi-platform influencer discovery and analysis
- Updated marketplace.json and auto-generated AGENTS.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 12:32:19 +01:00
Dusan Vystrcil dee369783d feat: add apify-market-research skill with 16 actors
Adds market research skill for analyzing market conditions, pricing, consumer behavior, and product validation. Includes 16 actors covering:
- Google Maps (density, geospatial data)
- Google Trends (regional interest trends)
- Facebook (marketplace pricing, events, groups, pages, photos)
- Instagram (hashtags, reels, stats, full data)
- Booking.com and TripAdvisor (hospitality market data)

New actor schemas generated: google-trends-scraper, facebook-marketplace-scraper, facebook-photos-scraper, instagram-hashtag-stats

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 12:15:25 +01:00
Dusan Vystrcil 24e0247b4e feat: add apify-competitor-intelligence skill with 28 actors
Add new competitor intelligence skill for analyzing competitor strategies,
content, pricing, ads, and market positioning across Google Maps, Booking.com,
Facebook, Instagram, YouTube, and TikTok.

- 17 actor schemas copied from lead-generation and brand-reputation-monitoring
- 11 new actor schemas generated from Apify Store
- Complete SKILL.md with workflow documentation
- reference/scripts/run_actor.py with actor runner and data export
- reference/workflows.md with multi-step competitor analysis examples

Marketplace version: 1.1.1 → 1.2.0
Skill version: 1.0.0 → 1.1.0

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 12:07:38 +01:00
Dusan Vystrcil eaade84e03 chore: remove hooks directory from gitignore
Hooks are now configured in .claude/settings.json for local development only.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 11:00:00 +01:00
Dusan Vystrcil c18e29c0ab feat: add apify-brand-reputation-monitoring skill
Add new brand reputation monitoring skill with Actor schema references for tracking reviews, ratings, and sentiment across Google Maps, Booking.com, TripAdvisor, Facebook, Instagram, YouTube, and TikTok.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 10:56:42 +01:00
patrikbraborec 7fd6354325 Rename actor-development command to create-actor and register as plugin
- Rename commands/actor-development.md to commands/create-actor.md
- Add apify-actor-commands plugin entry in marketplace.json
- Register /create-actor as available command in Claude Code

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-16 18:00:43 +01:00
patrikbraborec 33b3fa761b Move actor-development command to top-level commands directory
Reorganize actor-development.md from skills/apify-actor-development/commands/ to top-level commands/ directory. Update all relative paths to reference files, changing from relative paths to repository-root-relative paths (skills/apify-actor-development/references/).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-16 17:35:52 +01:00
patrikbraborec b276afeea2 Add guided actor development command workflow
Adds a systematic 10-phase workflow command for developing Apify Actors,
covering discovery, environment setup, language selection, architecture
design, implementation, testing, and deployment with best practices.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-16 17:19:24 +01:00
patrikbraborec 1dbc05cc74 Rename actor-development skill to apify-actor-development
Add apify- prefix to distinguish from potential third-party skills with similar names.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 16:44:14 +01:00
patrikbraborec ff56b41572 Move actor-development from plugins to skills directory
Restructure actor-development from plugins/actor-development to skills/actor-development to align with the repository structure. Update marketplace.json, README.md, and AGENTS.md to reflect the new location.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 16:41:17 +01:00
patrikbraborec 2e092f4deb Add Agent Skills for Actor Development 2026-01-14 16:40:14 +01:00
patrikbraborec 04d9ae9e8b Add Actor Development skill 2026-01-14 16:40:14 +01:00
Dušan Vystrčil 321567d66a Merge pull request #5 from apify/dev
chore: add apify- prefix to skill names for branding
2026-01-14 16:15:49 +01:00
Dusan Vystrcil 49079ca3c9 chore: add apify- prefix to skill names for branding
Rename lead-generation to apify-lead-generation so users can
distinguish Apify marketplace skills from their own custom commands.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 16:14:58 +01:00
Dušan Vystrčil 4fcc62bce0 Merge pull request #4 from apify/dev
feat: auto-update USER_AGENT version when bumping skill versions
2026-01-14 15:49:45 +01:00
Dusan Vystrcil 1da6bafe67 feat: auto-update USER_AGENT version when bumping skill versions
The generate_agents.py script now updates USER_AGENT in run_actor.py
when bumping skill versions, keeping tracking versions in sync.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 15:48:13 +01:00