agentleFS
johnisanerdjohnisanerd/claude-skill-company-data-api/apify-company-data-api/SKILL.md

apify-company-data-api

Skill0 starsChanged 2 months agoMITView on GitHub

Pull structured B2B company data from Clutch.co with the Clutch.co Agency API Actor (johnvc/clutch-agency-api). Give it company profile URLs or bare slugs and get one flat JSON record per company: name, website, rating, review_count, verification badges, min_project_size, hourly_rate, employees, founded_year, headquarters and every office location, languages, service_lines and focus_areas with percentages, industries, clients, cost_rating, most_common_project_size, pricing_by_service, and published packages. Each profile row can also carry LLM-ready markdown at no extra fetch, and verified client reviews as their own rows. Use when someone wants a company data api, to enrich a CRM with firmographics and service mix, pull B2B service provider records, or turn a list of agency profiles into structured company data as JSON. Billed per profile delivered with no start fee, and MCP-ready for Claude and other AI agents.

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 1

    1. apify/awesome-skills★ 29377% same

    Wrote their own version · 0

    None found.

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 2 are distinctive, and 4 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Not for: building the list of companies in the first place.

    line 23
  2. Distinctive:

    Read the rows back from a finished run:

    line 82
  3. Very specific:

    Every call carries the three flags this repo expects: --json (or --format json), --user-agent apify-awesome-skills/apify-company-data-api, …

    line 90
  4. Distinctive:

    Start with one or two profiles and reviews off.

    line 102
  5. Very specific:

    Keep outputFormats at ["json"] for CRM fields.

    line 104
  6. Very specific:

    Check result_type before treating a row as a company.

    line 107

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Clutch Company Data, as Flat JSON Records

Profile URLs or bare slugs in, full B2B company records out: firmographics, service mix, pricing bands, and review ratings, each already parsed into fields you can map onto a CRM.

When to use this skill

  • You need a company data api and found only enterprise firmographic vendors you cannot self-serve.
  • You are enriching a CRM or a prospect list with what a buyer actually weighs: verified ratings, published rates, minimum project size, and service mix.
  • You have a list of Clutch profiles (or just slugs) and want each one as structured JSON, not a page to read.
  • You want the company record and its client reviews from a single run.

Not for: building the list of companies in the first place. To walk a Clutch category or location directory and collect every agency on it, use the companion apify-marketing-agency-database skill, built on the same Actor in directory mode. See references/actor-index.md.

What you get

One dataset row per company. result_type separates profile rows from review and error rows. The companies dataset view shows the profile columns; the reviews view shows review rows.

Profile fields:

  • name, slug, profile_url, website (the real homepage, with tracking parameters stripped)
  • rating, review_count, is_verified, verification (badge list)
  • min_project_size, hourly_rate, employees, founded_year
  • headquarters, locations (every office, with a headquarters flag), languages, timezones
  • service_lines, focus_areas, industries, clients: each a list of name plus percentage
  • cost_rating, most_common_project_size, pricing_by_service, packages
  • review_ratings (quality, schedule, cost, willing_to_refer), top_mentions
  • markdown (Clutch's own LLM-ready rendering, default add-on), html (opt-in)
  • fetched_at

Review rows (when includeReviews is on) carry title, rating, the quality/schedule/cost/willing-to-refer breakdown, project_services, project_size, project_length, reviewer, reviewer_industry, and Clutch's project and feedback summaries.

Prerequisites

The Actor

Run it with the Apify CLI

Three company profiles as JSON plus markdown, reviews off for lean records:

apify actors call "johnvc/clutch-agency-api" -i '{"mode":"profiles","profileUrls":["ignite-visibility","lounge-lizard","geniusee"],"includeReviews":false,"outputFormats":["json","markdown"],"maxItems":10}' \
  --json \
  --user-agent apify-awesome-skills/apify-company-data-api \
  2>/dev/null

One company with its full firmographics and every verified review, capped:

apify actors call "johnvc/clutch-agency-api" -i '{"mode":"profiles","profileUrls":["https://clutch.co/profile/ignite-visibility"],"includeReviews":true,"maxReviewsPerProfile":50,"maxItems":100}' \
  --json \
  --user-agent apify-awesome-skills/apify-company-data-api \
  2>/dev/null

Confirm the live schema and prices before a large batch:

apify actors info "johnvc/clutch-agency-api" --input --json \
  --user-agent apify-awesome-skills/apify-company-data-api \
  2>/dev/null

Read the rows back from a finished run:

apify datasets get-items <DATASET_ID> --format json \
  --user-agent apify-awesome-skills/apify-company-data-api \
  2>/dev/null

Every call carries the three flags this repo expects: --json (or --format json), --user-agent apify-awesome-skills/apify-company-data-api, and 2>/dev/null.

Run it from Claude or another AI agent (MCP)

The Actor is MCP-ready. Add the hosted server URL:

https://mcp.apify.com/?tools=actors,docs,johnvc/clutch-agency-api

Then ask, for example: "Pull the full company records for ignite-visibility and geniusee from Clutch, with service mix and pricing bands, and give me the websites and hourly rates." MCP setup docs: https://docs.apify.com/platform/integrations/mcp

Workflow

  1. Start with one or two profiles and reviews off. Look at the row shape before you pay for a wide batch.
  2. A bare slug works as input. ignite-visibility and https://clutch.co/profile/ignite-visibility mean the same thing.
  3. Keep outputFormats at ["json"] for CRM fields; add "markdown" for a RAG pipeline (it costs nothing extra) and "html" only when you need the raw page (it costs a second request).
  4. Turn includeReviews on only when you want the review rows; each review is its own billed row, so maxReviewsPerProfile is your cap.
  5. Map name, website, headquarters, employees, and min_project_size straight onto CRM fields. Every row is flat JSON.
  6. Check result_type before treating a row as a company. An error row carries error_message and error_type.
  7. maxItems is the hard spend ceiling for the whole run, reviews included.

Inputs

  • mode (enum directory, profiles, search): use profiles for this workflow.
  • profileUrls (array): company profile URLs or bare slugs, mixed freely.
  • includeReviews (boolean, default true): return every verified review as its own row.
  • maxReviewsPerProfile (integer): cap on reviews per company; reviews paginate until this or the declared total.
  • outputFormats (array of json, markdown, html, default ["json","markdown"]): html costs a second fetch.
  • maxItems (integer): the hard delivery ceiling for the run. Use it as a spend cap.

Thin profiles are common: a large share of Clutch companies have no reviews and little published detail, so those rows return what exists rather than guessing.

Cost

Billing is pay per event with no start fee, so a run that returns nothing costs almost nothing. Confirm live prices with the info command above rather than trusting a number copied here.

The profile-scraped event fires once per company record delivered. review-scraped fires once per verified review row, only when includeReviews is on. There is no charge for the markdown add-on. A company that appears more than once in your input is de-duplicated and billed once.

Suggested confirmation thresholds: mention the estimate under about $5, warn the user over about $5, get explicit confirmation over about $20. Present cost as "around $X", never as a guarantee.

Honest limits

  • Many Clutch profiles are genuinely thin. has_reviews is decided by real review entries, not by the boilerplate reviews heading, so a company with no reviews returns a short record honestly.
  • Reviews come only from what Clutch publishes; nothing is inferred by a model.
  • Public profile data only. No emails scraped from behind a login, no private contact data.
  • The website is the company's real homepage with referral tracking parameters removed, so it is safe as a dedupe key.

Troubleshooting

  • Zero rows and no error row: check result_type. A profiles run with a bad slug returns an error row rather than silently dropping it.
  • A profile with very few fields: that company's Clutch page is genuinely thin, not a parse failure.
  • Duplicates across runs: dedupe downstream on profile_url or slug, never on name.
  • Reviews look short: raise maxReviewsPerProfile; page one already carries the first block.

See references/gotchas.md for cost guardrails and error recovery, and references/actor-index.md for the Actor routing table.

Related Actors

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.