69 Commits

Author SHA1 Message Date
Dušan Vystrčil 60c01e8ab4 Merge pull request #3 from apify/dev
feat: add User-Agent tracking and update README
2026-01-14 15:43:34 +01:00
Dusan Vystrcil b20a2549c7 feat: add User-Agent tracking and update README output formats
- Add User-Agent header to API calls for usage analytics tracking
- Track start_actor, download_csv, download_json, and quick_answer calls
- Remove redundant Supported Apify Actors table from README
- Update Output Format section to document all supported formats

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 15:42:20 +01:00
Dušan Vystrčil 3a482b2eda Merge pull request #2 from apify/dev
feat: reorganize repository to flat skills structure
2026-01-14 15:15:23 +01:00
Dusan Vystrcil b176803efa chore: remove hooks from repo (personal dev only)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 15:05:50 +01:00
Dusan Vystrcil 20a7640e80 chore: rename skill from generating-leads to lead-generation
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 14:51:32 +01:00
Dusan Vystrcil cae58117ad feat: reorganize repository to flat skills structure
- Move skills directly to skills/ folder (from plugins/*/skills/)
- Add multi-tool support (Codex, Gemini CLI, Cursor) via agents/AGENTS.md
- Add generate_agents.py script with auto-generation and version bumping
- Add GitHub Actions workflow for CI validation
- Add Claude Code hook for auto-regeneration on commit
- Update README with new repo URL (github.com/apify/agent-skills)
- Add gemini-extension.json for Gemini CLI compatibility

BREAKING CHANGE: Repository structure changed from plugins/ to skills/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 14:32:36 +01:00
Dušan Vystrčil 1324dfb8fa Merge pull request #1 from apify/dev
Bump versions and add installation verification
2026-01-08 18:33:49 +01:00
Dusan Vystrcil ef95a2f491 Bump versions and add installation verification
- Update marketplace version to 1.0.3
- Bump lead-generation plugin to 2.0.15
- Add /skills verification instructions to README

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 18:29:58 +01:00
Dusan Vystrcil ca592920a3 Streamline workflows documentation to focus on advanced multi-step examples
- Keep only 2 advanced workflows (B2B Lead List, YouTube Creator Lead Generation)
- Remove 7 redundant basic workflow examples already documented in Actor reference files
- Remove Common Follow-up Actions section
- Fix Actor IDs to use correct authors (streamers/youtube-scraper)
- Bump plugin version to 2.0.14

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 17:37:49 +01:00
Dusan Vystrcil 3d5fbfb56b Add essential fields and quick answer output format
- Define essential fields for all 18 Actors in generating-leads skill
- Add Quick answer output mode: displays top 5 results in chat with link to full dataset
- Add --fields parameter to run_actor.py (all/basic) for data completeness control
- Make --output parameter optional to enable chat display mode
- Support nested field extraction using dot notation (e.g., authorMeta.name)
- Update SKILL.md with new output format options and examples
- Bump version to 2.0.13

Allows users to get concise results directly in chat without creating files, with option to export basic fields or complete data to CSV/JSON as needed.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 17:17:44 +01:00
Dusan Vystrcil 9744b77e75 Update documentation and standardize configuration
- Update repository URL to https://github.com/apify/claude-code-plugins
- Bump marketplace version 1.0.1 → 1.0.2 and plugin version 2.0.11 → 2.0.12
- Expand supported Actors table from 6 to 18 actors with platform grouping
- Standardize actor ID format to forward slash (author/actor) throughout
- Standardize capitalization of "Actor" as Apify product name
- Update marketplace.json name to "apify" and improve descriptions
- Add comprehensive keywords and platform details

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 12:25:13 +01:00
Dusan Vystrcil b49abf5d42 Add cost transparency and workflow documentation to actor guides
- Add Pricing Breakdown sections to Google Maps and Google Search scrapers
  showing base costs, optional add-ons, and premium features with 🚨 warnings
- Add Common Use Cases (7 per actor) with practical examples and cost estimates
  ranging from free tier to premium features ($100-$200 per 1,000 results)
- Add Cost Management Guidelines for AI with clear prompts for when to ask
  users about paid features and how to estimate costs
- Include AI workflow instructions for each use case with confirmation patterns
- Provide cost control strategies and cheaper alternatives for premium features
- Bump plugin version to 2.0.11

Prevents surprise costs by defaulting to free tier and requiring explicit
user confirmation before enabling paid features. Critical for expensive
add-ons like business leads enrichment ($100/1,000) and AI modes ($200/1,000).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-08 11:24:07 +01:00
Dusan Vystrcil 7704a51f68 Add Instagram and TikTok actor schemas and bump version to 2.0.10
Added comprehensive actor documentation for:
- Instagram: search, posts/comments, tagged posts scrapers
- TikTok: main scraper, free scraper, user search, followers scrapers
- Facebook: events and page contact information scrapers

Updated SKILL.md with new actor references and README with local business discovery use case. Bumped plugin version from 2.0.9 to 2.0.10.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-08 10:42:06 +01:00
Dusan Vystrcil 1cbb554589 Standardize actor ID format to tilde notation and add auto-conversion
- Update actor IDs from slash (author/actor) to tilde (author~actor) format in examples
- Add automatic conversion in run_actor.py to handle both formats transparently
- Bump plugin version to 2.0.9

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 10:04:15 +01:00
Dusan Vystrcil 788f75a56b Consolidate actor documentation and add schema reading step
- Merge duplicate "Determine Lead Source" and "Actor Reference Documentation" sections into a single table
- Add explicit Step 2 for reading actor schema from reference docs
- Include direct links to schema files in lead source table
- Update workflow step numbering accordingly
- Bump plugin version to 2.0.7

This reduces token waste from duplication and clarifies the workflow.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 09:47:25 +01:00
Dusan Vystrcil 2596ed88f5 Restructure actor reference documentation into individual files
Split the monolithic actors.md (1100+ lines) into 9 focused actor reference files in reference/actors/ directory, each named with full author/actor ID for clarity:
- compass-crawler-google-places.md
- vdrmota-contact-info-scraper.md
- apify-instagram-profile-scraper.md
- clockworks-tiktok-profile-scraper.md
- apify-facebook-pages-scraper.md
- apify-facebook-groups-scraper.md
- apify-google-search-scraper.md
- streamers-youtube-scraper.md
- poidata-google-maps-email-extractor.md

Updated SKILL.md to include indexed reference documentation with direct links to each actor file. Fixed actor ID format from tilde (~) to forward slash (/) notation throughout. Corrected google-maps-email-extractor author from apify to poidata.

This improves maintainability, navigation, and prevents naming conflicts between actors from different developers.
2026-01-08 09:37:54 +01:00
Dusan Vystrcil 10812cc8f2 Add four new use case examples to lead-generation plugin README
Expand the Real-World Examples section with TikTok, YouTube, partnership development, and CRM enrichment examples. This provides better coverage of the supported platforms and demonstrates additional lead generation scenarios.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 14:22:34 +01:00
Dusan Vystrcil c3f17dc622 Restructure lead-generation plugin to follow best practices
- Reorganize skill structure: create reference/ subfolder for actors.md, workflows.md, and scripts/
- Rename skill from lead-finder to generating-leads following naming conventions
- Remove deprecated slash commands (find-businesses, enrich-contacts, prospect-groups, scrape-profiles)
- Rewrite README.md with human-friendly content and real-world examples from usecases.csv:
  * Local business prospecting (coffee bean wholesaler)
  * Software company lead generation (executive coach)
  * Influencer discovery (travel brand)
  * Contact enrichment (marketing team)
  * Social media prospecting (eco-friendly brand)
- Update plugin metadata: version 1.0.3 → 2.0.1, expand keywords with platform names
- Update all internal path references in SKILL.md and workflows.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 14:12:29 +01:00
Dusan Vystrcil 39b0eeac3c Init setup 2026-01-07 13:28:52 +01:00