# Website Color Palette — CSS Colors With Alpha and Usage Counts (`hermeskd/website-color-palette`) Actor

Website color palette: Static CSS color literals, alpha values and occurrence counts. $0.001 per page parsed; start extra; usage included; failed results uncharged.

- **URL**: https://apify.com/hermeskd/website-color-palette.md
- **Developed by:** [Logan Parker](https://apify.com/hermeskd) (community)
- **Categories:** Developer tools, Business, Agents
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 page parseds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

Website color palette extraction reads declared CSS color literals from public HTML and bounded linked stylesheets, returning alpha and occurrence counts without rendering or claiming visual dominance. AI agents can call and pay through Apify MCP. List event rates are $0.001 per page parsed; start is extra, usage is included and failed results are uncharged.

### Example result

Example record for the minimal input under How to use it, as this Actor returned it on 2026-10-30 in a run of its production image; the record is kept unchanged with the release.

```json
{
  "url": "https://docs.apify.com/",
  "ok": true,
  "colors": [
    {
      "hex": "#2a2a2a",
      "alpha": 1.0,
      "occurrences": 5
    },
    {
      "hex": "#454545",
      "alpha": 1.0,
      "occurrences": 5
    },
    {
      "hex": "#0f0f0f",
      "alpha": 1.0,
      "occurrences": 3
    },
    {
      "hex": "#14441f",
      "alpha": 1.0,
      "occurrences": 3
    },
    {
      "hex": "#152447",
      "alpha": 1.0,
      "occurrences": 3
    },
    {
      "hex": "#1d1d1d",
      "alpha": 1.0,
      "occurrences": 3
    },
    {
      "hex": "#246dff",
      "alpha": 1.0,
      "occurrences": 3
    },
    {
      "hex": "#383838",
      "alpha": 1.0,
      "occurrences": 3
    },
    {
      "hex": "#672523",
      "alpha": 1.0,
      "occurrences": 3
    },
    {
      "hex": "#ef6045",
      "alpha": 1.0,
      "occurrences": 3
    },
    {
      "hex": "#00531e",
      "alpha": 1.0,
      "occurrences": 2
    },
    {
      "hex": "#006e29",
      "alpha": 1.0,
      "occurrences": 2
    }
  ],
  "colorCount": 12,
  "stylesheetCount": 0,
  "parsedDeclarations": 183,
  "warnings": [
    "stylesheet_too_large",
    "unsupported_color_syntax"
  ]
}
```

### How to use it

Start a run in Apify Console, by API or from an agent with an input like this one — it is the input Apify runs every day to test this Actor:

```json
{"urls": ["https://docs.apify.com/"]}
```

Start with the minimal JSON example above, then adjust the fields in the table below. Read the Example result and Output fields sections for the returned record, Errors for failure codes, and Events and prices for result events and the separate platform start.

| Field | Type | Meaning |
|---|---|---|
| `urls` | array | 1–20 public HTML pages, up to 1 MB each; at most five initially same-origin linked stylesheets, 200 KB each. Static CSS Color 3 literals only, with alpha; no rendered dominance, JavaScript, variable resolution, modern color functions or variable names. Refused/unreadable CSS is a partial-result warning. |
| `maxColors` | integer | Maximum literal colors returned, ordered by occurrence then hex/alpha. |
| `maxStylesheets` | integer | Maximum initially same-origin linked stylesheets fetched. |

### Events and prices

| Event | Title | Charged when | FREE / BRONZE | SILVER | GOLD / PLATINUM / DIAMOND |
|---|---|---|---|---|---|
| `page-parsed` | Page parsed | One successful input processed and its readable result written. | $0.001 | $0.0009 | $0.0008 |

Platform usage is not passed through. Apify's automatic actor-start event remains $0.00005 per started GB (one GB or less counts once). The synthetic dataset-item event is absent. Charge limits stop further paying work; unprocessed inputs receive uncharged errors. Completed readable pending events are settled on abort.

Worked cost example: ten successful page parsed events cost $0.01 at list, plus actor start. Failures are not included in that count.

### Call it from an agent

Through Apify's MCP server (https://mcp.apify.com) use `call-actor`:

```json
{
  "actor": "hermeskd/website-color-palette",
  "input": {
    "urls": [
      "https://docs.apify.com/"
    ]
  },
  "callOptions": {
    "maxTotalChargeUsd": 0.1,
    "timeout": 600
  },
  "waitSecs": 30
}
```

Then call `get-dataset-items` with the returned defaultDatasetId. Dedicated tool URL: https://mcp.apify.com?tools=hermeskd/website-color-palette

### Output fields

| Field | Meaning |
|---|---|
| `url` | The original input entry. |
| `ok` | True for a returned result; a failure is never charged. |
| `colors` | Canonical hex, alpha and literal occurrence count only. |
| `colorCount` | Number of returned colors. |
| `stylesheetCount` | Linked stylesheets successfully parsed. |
| `parsedDeclarations` | CSS declarations inspected. |
| `warnings` | Partial-result limitations/refusals, never raw source text. |
| `error` | Failure, always uncharged. |

### Limits and run time

1–20 public HTML pages, up to 1 MB each; at most five initially same-origin linked stylesheets, 200 KB each. Static CSS Color 3 literals only, with alpha; no rendered dominance, JavaScript, variable resolution, modern color functions or variable names. Refused/unreadable CSS is a partial-result warning.

The default run timeout is 600 seconds. Three local cold typical calls took 8.6–9.7 seconds including container startup. Source latency and platform startup vary.

### Errors

| Code | Meaning |
|---|---|
| `http_error` | The source answered an unsuccessful HTTP status. |
| `download_failed` | The request or connection failed within its bounded deadline. |
| `unsupported_content_type` | The response is not HTML. |
| `robots_disallowed` | robots.txt forbids fetching the URL; no request was made to it. |
| `blocked_host` | The host is on the deny-list or resolves to a private or local address; no request was made. |
| `too_large` | The response exceeded the size cap. |
| `timeout` | The input did not finish within the run's time budget. |
| `invalid_input` | The run input passed the input schema but cannot be used; the message names the field. |
| `internal_error` | Unexpected failure; the message carries the error class. |
| `charge_limit_reached` | The run reached its maximum total charge; this input was not processed. |

No failure record is charged. A run fails only when all input outcomes are Actor-side failures; caller errors and a mixture of caller/Actor failures do not fail the run.

### Sources and terms

Only process content you have the right to process. URL fetches obey HermesBot robots-group selection, the shared deny-list, public-address checks on connections and redirects, honest identity, deadlines and rate limits. No caller credentials, cookies, CAPTCHA solving, residential proxies or evasion. Caller-authorized public pages under the shared fetch policy. Documentation prefill is Apache-2.0 and robots permits it; W3C document permissions and tinycss2 BSD-3-Clause license read. Only numerical color values/counts are returned; no contacts, social links or page text.

### Not affiliated

This independently developed Actor is not affiliated with the named source providers or model authors.

### Related Hermes Actors

- [AI Crawler Checker: Which AI Bots robots.txt Allows per URL](https://apify.com/hermeskd/ai-crawler-access-check) — check declared robots.txt permissions for six AI crawlers at URL paths.
- [Article Extractor — News & Blog Text, Date and Markdown by URL](https://apify.com/hermeskd/article-extractor) — an article's clean text, title and publish date, without the rest of the page.
- [100K+ indexed jobs — Career Site Jobs API | 2026-11-03](https://apify.com/hermeskd/ats-job-search) — search open jobs in the Hermes directory of Greenhouse and Lever boards, each confirmed live.
- [Speech to Text — Transcribe Audio & Video URLs, Speaker Labels](https://apify.com/hermeskd/audio-to-transcript) — speech to text with SRT and VTT subtitles.
- [Video Converter — MP4 to MP3, Trim, GIF and Audio Extraction](https://apify.com/hermeskd/audio-video-convert) — audio and video conversion: MP4 to MP3, trim, GIF.
- [Broken Links Checker — Links, Assets, Redirects and Their Pages](https://apify.com/hermeskd/broken-links) — broken links, 404s and redirects on a site.
- [100K+ indexed jobs — Company ATS Finder API | 2026-11-03](https://apify.com/hermeskd/company-ats-board) — which hiring system and job board a company uses.
- [SEC EDGAR Filings — Recent Company Forms, Dates and XBRL Flags](https://apify.com/hermeskd/company-filing-index) — Read recent company financial filing metadata from the official SEC JSON API
- [DOI Lookup — Crossref Titles, Venues, Dates and Citation Counts](https://apify.com/hermeskd/crossref-doi-metadata) — crossref doi metadata.
- [CVE Vulnerability Lookup — NVD CVSS Scores and Exploited Flags](https://apify.com/hermeskd/cve-risk-metrics) — look up NVD CVE dates, status, numeric CVSS scores and severity.
- [Merge JSON Datasets — Deduplicate Rows, Export JSON and CSV](https://apify.com/hermeskd/dataset-json-cleaner) — json dataset cleaner.
- [DNS Lookup — Records, SPF Lookup Counts, DKIM & DMARC by Domain](https://apify.com/hermeskd/dns-and-email-auth) — DNS records and SPF, DKIM and DMARC checks.
- [DOCX to Markdown — Word, Excel, PowerPoint and EPUB Converter](https://apify.com/hermeskd/document-to-markdown) — Word, Excel, PowerPoint and other office files to Markdown.
- [Domain Availability Checker — Bulk RDAP Status and Registrar](https://apify.com/hermeskd/domain-availability) — whether domain names are available, from registry RDAP.
- [USGS Earthquake Lookup — Event Magnitude, Depth, Coordinates](https://apify.com/hermeskd/earthquake-event-metrics) — Read numeric USGS earthquake metadata for known event identifiers.
- [Currency Exchange Rates — ECB Daily Euro Rates and Cross Pairs](https://apify.com/hermeskd/ecb-exchange-rates) — Read latest ECB daily currency reference rates and calculated cross pairs.
- [Bulk File Downloader — Save URL Lists to Storage With SHA-256](https://apify.com/hermeskd/file-downloader) — files and images from URLs, saved with a public link each.
- [GitHub Repo Stats — Stars, Forks, Subscribers and Open Issues](https://apify.com/hermeskd/github-repository-metrics) — Read numeric metrics for known public GitHub repositories.
- [47K+ Greenhouse jobs — Live API | 2026-11-03](https://apify.com/hermeskd/greenhouse-jobs) — every open job on a company's Greenhouse board.
- [Hacker News Story Metrics — Scores, Comment Counts, Timestamps](https://apify.com/hermeskd/hacker-news-story-metrics) — read numeric Hacker News story scores, timestamps and comment counts by ID.
- [HTTP GET Request — Bulk Response Bodies, Status and SHA-256](https://apify.com/hermeskd/http-get-response) — public http get.
- [Security Headers Checker — HSTS, CSP, Framing, Nosniff by URL](https://apify.com/hermeskd/http-security-headers) — Check seven declared HTTP security header families without returning raw values.
- [Image Background Remover — U2NetP Cutouts for JPEG, PNG, WebP](https://apify.com/hermeskd/image-background-remover) — Remove image backgrounds with the small U2NetP model and return transparent PNG pixels as base64
- [Image Converter — JPEG, PNG and WebP With Resize and Quality](https://apify.com/hermeskd/image-format-converter) — image format converter.
- [Image Metadata Remover — EXIF and GPS Scrub, Pixels Verified](https://apify.com/hermeskd/image-metadata-remover) — GPS location, camera serial numbers and other private metadata removed from photos, losslessly.
- [Image to Text OCR — Text With Word Positions and Confidence](https://apify.com/hermeskd/image-to-text) — OCR: the text in images.
- [Image Upscaler — Real-ESRGAN 2x/4x for Photos and Graphics](https://apify.com/hermeskd/image-upscale) — image upscaling 2x or 4x, and photo restoration.
- [25K+ Lever jobs — Live API | 2026-11-03](https://apify.com/hermeskd/lever-jobs) — every published job on a company's Lever site, global or EU.
- [Lighthouse Audit — Lab Web Vitals and Scores, Mobile & Desktop](https://apify.com/hermeskd/lighthouse-audit) — Lighthouse scores and Core Web Vitals.
- [npm Package Lookup — Latest Version, License, Dependency Count](https://apify.com/hermeskd/npm-package-metadata) — read latest npm package versions, license tokens and dependency counts.
- [Website Change Monitor — Page Text Diffs Against Your Snapshots](https://apify.com/hermeskd/page-change-monitor) — what changed on a page since the last check.
- [PDF to Markdown — PDF Parser & Text Extractor With OCR](https://apify.com/hermeskd/pdf-to-markdown) — PDF to Markdown and text, with OCR for scanned pages.
- [Public Holidays Calendar — Holiday Dates for Five Countries](https://apify.com/hermeskd/public-holiday-calendar) — build offline public-holiday calendars for five countries and bounded years.
- [99 Remote OK jobs — Remote OK Feed API | 2026-11-02](https://apify.com/hermeskd/remote-jobs) — current remote jobs from Remote OK, with salary and listing links.
- [Research Paper Search — OpenAlex Papers, DOIs, Citation Counts](https://apify.com/hermeskd/research-paper-search) — Search OpenAlex for work-level paper metadata without authors, affiliations, abstracts or full text
- [RSS Feed Reader — Atom and JSON Feed Parser With Enclosures](https://apify.com/hermeskd/rss-feed-reader) — every item of an RSS, Atom or JSON feed.
- [SEO Audit — On-Page Score, Meta Tags, Schema & Fix Guidance](https://apify.com/hermeskd/seo-page-audit) — an on-page SEO audit: meta tags, schema, headings and links.
- [Sitemap Extractor — Unique URLs From XML, Gzip & Index Sitemaps](https://apify.com/hermeskd/sitemap-urls) — the URLs in a site's sitemaps.
- [Text to Speech — Offline English, German, Spanish WAV Voices](https://apify.com/hermeskd/text-to-speech) — Convert short nonpersonal texts to offline formant WAV speech for agents
- [Time Zone Converter API](https://apify.com/hermeskd/timezone-converter) — Convert one offset-qualified instant to named IANA time zones using pinned data.
- [URL to Markdown — Clean Text for LLM & RAG, With Selectors](https://apify.com/hermeskd/url-to-markdown) — a public job page as clean Markdown where the site allows it (deny-listed job sites are refused).
- [Extract Video Frames — Timed Stills by Interval or Scene Cut](https://apify.com/hermeskd/video-frames) — frames, thumbnails and scenes from a video.
- [Favicon Extractor — Icons, Touch Icons, Manifests, Theme Color](https://apify.com/hermeskd/website-icon-manifest) — declared website icons, theme colors and manifest links.
- [Website Screenshot — Full Pages, Elements, Dark Mode & PDF](https://apify.com/hermeskd/website-screenshot) — screenshots and PDF prints of web pages.
- [Tech Stack Detector — Website Technologies With Match Evidence](https://apify.com/hermeskd/website-tech-stack) — the technologies a website runs, detected live.
- [Website Crawler to Markdown — Same-Site Pages for LLM and RAG](https://apify.com/hermeskd/website-to-markdown) — bounded whole-site Markdown with robots and crawl-delay enforced

### Changelog

- 1.0 (2026-10-30) — first implementation; demand-led wave 3.

# Actor input Schema

## `urls` (type: `array`):

1–20 public HTML pages, up to 1 MB each; at most five initially same-origin linked stylesheets, 200 KB each. Static CSS Color 3 literals only, with alpha; no rendered dominance, JavaScript, variable resolution, modern color functions or variable names. Refused/unreadable CSS is a partial-result warning.

## `maxColors` (type: `integer`):

Maximum literal colors returned, ordered by occurrence then hex/alpha. Accepted range: 1–32, inclusive.

## `maxStylesheets` (type: `integer`):

Maximum initially same-origin linked stylesheets fetched. Accepted range: 0–5, inclusive.

## Actor input object example

```json
{
  "urls": [
    "https://docs.apify.com/"
  ],
  "maxColors": 12,
  "maxStylesheets": 3
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://docs.apify.com/"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("hermeskd/website-color-palette").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "urls": ["https://docs.apify.com/"] }

# Run the Actor and wait for it to finish
run = client.actor("hermeskd/website-color-palette").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://docs.apify.com/"
  ]
}' |
apify call hermeskd/website-color-palette --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hermeskd/website-color-palette"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/jL9vgUhj4aZ4sLcKB/builds/vO1v07zf2NUy3gSng/openapi.json
