Available Context

@_platform-references/org-variables.md

AI Ark Company Search

Goal

Search AI Ark's company database to find businesses matching firmographic criteria.

Credit Cost

Each company search request costs ~2.5 credits regardless of result count. Use preview_mode: true to fetch 5 results first (same 2.5 credit cost) before running a full search. Always warn the user before executing a paid search.

Required Capabilities

• AI Ark API: Company search endpoint via ai-ark-search edge function (action: 'company_search')

Inputs

• industry: Industry vertical — use exact AI Ark industry names (lowercase). Examples:
  • software development, it services and it consulting, financial services, hospitals and health care
  • real estate, manufacturing, retail, advertising services, staffing and recruiting, insurance
  • telecommunications, investment management, e-learning providers, technology information and internet
  • business consulting and services, human resources services, information services
  • environmental services, research services, accounting, legal services, construction
  • food and beverage manufacturing, medical equipment manufacturing, oil and gas
  • chemical manufacturing, biotechnology, higher education, government administration
• employee_count_range: Company size (e.g. '1-10', '11-50', '50-200', '200-500', '500-1000', '1000+')
• location: Geographic filter — country, city, or region
• technology_keywords: Tech stack requirements — use exact AI Ark technology names. Examples:
  • amazon aws, microsoft office 365, google cloud hosting, salesforce, hubspot, zendesk
  • stripe, shopify, wordpress, react, python, java, docker, kubernetes, terraform
  • github, slack, zoom, notion, airtable, snowflake, databricks, tableau, looker
  • segment, mixpanel, amplitude, twilio, sendgrid, marketo, pardot, drift, gong
  • outreach, salesloft, greenhouse, lever, workday, netsuite, sap, oracle, cloudflare
• revenue_range: Revenue bracket (e.g. '$1M-$10M', '$10M-$50M')
• founded_year: Founding year or range (e.g. '2020', '2018-2023')
• preview_mode: Fetch 5 results first for quick validation

Execution

1. Confirm intent: clarify any ambiguous industry or tech filters
2. Warn the user: "This search will cost ~2.5 AI Ark credits. Proceed?" (or offer preview first)
3. Optionally run with preview_mode: true to show 5 results before committing
4. On confirmation, call ai-ark-search with action: 'company_search' and provided filters
5. Present results as a table for review

Output Contract

Return a table with columns:

• Company Name, Domain, Industry, Employee Count, Employee Range, Location, Description, Technologies, LinkedIn, Website

Show total_count to give the user a sense of the full dataset size.