SaaS Battlecard Generator
Pricing
from $28.00 / 1,000 battlecard generateds
Generate sales battlecards from competitors' public pricing and feature pages: plan tiers and prices, a feature matrix, strengths and weaknesses, objection handling and win/loss tips, with a source URL for every fact. JSON, markdown and a one-pager per competitor.
All notable changes to this Actor are documented here. The format follows
Keep a Changelog , and the project tries to
adhere to Semantic Versioning — MAJOR.MINOR.PATCH.
LICENSE is now an all-rights-reserved notice (was MIT).Mozilla/5.0 (compatible; AIDevsBot/1.0; +https://apify.com/entranced_gelato/saas-competitor-battlecards)
(was SaaSCompetitorBattlecardsBot/0.3 (...)). The user_agent override
still works; its description asks for an honest User-Agent.AIDevsBot group, else the old
SaaSCompetitorBattlecardsBot group, else *; longest match wins, */$
wildcards. 401/403 disallow the site; other 4xx allow everything; 429,
5xx, network errors and timeouts now disallow the site for the run (they
used to fail open). A custom User-Agent can only add restrictions.
Redirects are followed by the Actor itself, so a disallowed redirect
target is never requested. A disallowed page gets a company note, a
robots_disallowed risk flag, a mention in the status message and in
RUN_SUMMARY.robots_disallowed, and is never billed.<name>.com/.io/.ai/... domains); with only a name,
probing stops at the first confirmed domain. Each page is requested at
most once per run (trailing slashes, redirects, a second company on the
same site), and the extractors reuse the pages discovery fetched instead
of requesting them again. max_pages_per_company is now a hard cap.our_company Apify, our_website
https://apify.com , competitors ["Linear"]; competitor_websites gained
the default {"Linear": "https://linear.app"} . sample_input.json, both
Store tasks (ClickUp left the market-scan task) and examples/ follow.tdmReserved
FAQ entries, "Wrong charge?" (Issues tab, 14 days), data-protection line,
demo-pair note, published example runs as plain text with a "not
affiliated" line, new limitations.Authorization: Bearer header
instead of ?token= (run_smoke.sh, configure_actor.py,
kill_switch.py, verify_listing.py); this also fixes kill_switch.py
listing running runs.tdmReserved and tdmPolicy on every page record
(companies[].pages[], sources[]): the page's TDMRep
tdm-reservation / tdm-policy header or <meta> tag (the tag wins).
Flags only; extraction still runs. Risk flag tdm_reserved.RUN_SUMMARY.robots_disallowed and the robots_disallowed risk flag.httpx.MockTransport), TDMRep, README text, dev-script token
handling, limited-permission use. Three robots.txt tests changed with
the new rules (5xx and network errors now disallow; a custom User-Agent's
own group no longer lifts the * rules).TERMS.md (an unfinished draft). Apify's Standard Actor Contract governs
use of Store Actors by default; the README points to it._ddg_search_top_hits).apify>=4.1,<5). The 4.x SDK knows the run's
pay-per-event pricing, so the Actor can see the user's maximum charge.
requirements.lock.txt regenerated on Python 3.11.apify-default-dataset-item event, titled "Battlecard generated"): $0.04
on the free plan, $0.036 Bronze, $0.032 Silver, $0.028 Gold and above.
Platform usage is included. The 0.2 notes below describe the old wording.no_data (website resolved but no pricing and no features extracted) and
duplicate (same website as an earlier company, including our own). Both
are explained by a risk flag, kept in OUTPUT, and never billed.comparison_generated is kept but charged only if the pricing defines it.OUTPUT.chargeable_event_count is the number of battlecards delivered.site_blocked, listed in
RUN_SUMMARY.blocked_sites and named in the status message. Missing data
is not billed.actor.json: title "SaaS Battlecard Generator", version 0.3, memory
256/512/1024 MB, MCP_SERVERS category removed (this is not an MCP server).RUN_SUMMARY key-value record: delivered competitors, and every
competitor not delivered with the reason (candidates_only, no_data,
duplicate, charge_limit_reached). Terminal status message per run.competitor_website and pricing_headline..actor/dataset_schema.json (overview + detail views),
.actor/output_schema.json (dataset, OUTPUT, RUN_SUMMARY),
.actor/store-listing.json (Store copy, synced by hand at deploy)..github/workflows/ci.yml) with an offline schema
check (scripts/validate_actor.py).disclaimer
field rendered at the top of battlecard_markdown and one_pager_text.
Travels with every dataset record and every MCP tool call.market_scan with three resolved competitors
produces three dataset records ($3); a head_to_head produces one ($1).
Each record carries primary_competitor for auditing.
(Prices superseded: see the live prices in 0.3 above.)candidates_only or failed no longer push a dataset record (no charge).
Users still see the result via the OUTPUT key-value record.chargeable_event_count + paid_event_name fields on every output —
transparent billing receipt.main.py — every run produces a
structured record (success or failed). No silent crashes.requirements.lock.txt) — production builds
pin every transitive version, immune to upstream drift..actorignore — keeps tests, dev requirements, scripts, and internal
roadmap docs out of the published image.scripts/run_smoke.sh +
scripts/smoke_test.py) — validates the spec contract against the
deployed Actor in both chargeable and non-chargeable branches.TERMS.md) inlined into the README so
visitors can read them without leaving the listing page.
(Removed on 2026-10-17: Apify's Standard Actor Contract applies.)ensure_scheme() is now case-insensitive on the scheme check
(HTTPS://x.com no longer gets double-prefixed).detect_billing_period() recognizes spaced variants like $10 / month
(real pricing pages use these).chunk_unique() filters whitespace-only strings.head_to_head strict semantics — flips to candidates_only if either
side fails to resolve, instead of mislabeling as partial.Actor.charge call ordering — billing fields are now stamped before
push_data so the dataset record reflects the billing decision.