Google Fonts Library Metadata Extractor: MCP config, n8n workflow and API

{
  "mode": "byFamily",
  "families": [
    "Roboto"
  ],
  "category": "Sans Serif",
  "maxItems": 3,
  "variableOnly": false,
  "colorOnly": false,
  "brandOnly": false,
  "notoOnly": false,
  "sortBy": "default",
  "includeLicense": false,
  "includeFiles": false,
  "maxFilesPerFamily": 10
}

---
name: google-fonts-library-metadata-extractor
description: "Google Fonts family records with category, weights, variable-font axes, subsets, designers, sparse popularity/trending ranks, dates, and specimen/CSS URLs. Optional enrichment adds license/attribution, source repository, languages/unicode coverage, CSS2 woff2 files with unicode ranges, and TTF download URLs. Runs the Apify Actor nimbryxo-studio/google-fonts-library-metadata-extractor. Use when the user needs Google Fonts Library data with fields such as family, category, isVariable, weights, subsets, designers and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "nimbryxo-studio/google-fonts-library-metadata-extractor"
  store-url: "https://apify.com/nimbryxo-studio/google-fonts-library-metadata-extractor"
---

# Google Fonts Library Metadata Extractor

Use this skill to fetch Google Fonts Library data with the Apify Actor `nimbryxo-studio/google-fonts-library-metadata-extractor` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | one of `byFamily`, `byCategory`, `listAll`, `icons`, required | What to fetch from Google Fonts. `icons` fetches the separate Material icon metadata document once and emits icon records; it does not return font-family records. |
| `families` | array | Font family names, e.g. `Roboto`, `Open Sans`, `Lora`, `Playfair Display`. Case-insensitive; `displayName` aliases and duplicates are handled. Defaults to `Roboto` when empty. |
| `category` | one of `Sans Serif`, `Serif`, `Display`, `Handwriting`, `Monospace` | Filter the library to a single font category. Defaults to `Sans Serif` when empty. An unknown category emits a typed `invalid_category` error record. |
| `maxItems` | integer | Hard cap on records emitted per run (1-5000). Defaults to 5000 so the whole font catalog (~1,959 families) fits without truncation. The icon endpoint currently reports about 6,139 icons, so `icons` mode can truncate at the cap. |
| `search` | string | Free-text search over family, display name, category, classifications, subsets, designers, and primary script/language. In `icons` mode it searches icon name, categories, tags, and supported families. All space-separated tokens must match. |
| `subsets` | array | Only keep families that include every listed subset, e.g. `latin`, `cyrillic`, `greek`, `vietnamese`. The synthetic `menu` subset is present on every family. |
| `designers` | array | Only keep families whose designer/foundry list contains every listed value (case-insensitive substring match). |
| `variableOnly` | boolean | Keep only families that ship a variable font with one or more axes. |
| `colorOnly` | boolean | Keep only families with color font capabilities (COLRV0/COLRV1/OTSVG). |
| `brandOnly` | boolean | Keep only families where the upstream `isBrandFont` flag is true. In the current catalog this flag equals `isNoto`; it is not a generic brand filter. |
| `notoOnly` | boolean | Keep only families in the Noto collection. |
| `sortBy` | one of `default`, `popularity`, `trending`, `dateAdded`, `lastModified`, `name`, `defaultSort` | Order the matched families. `popularity` and `trending` are sparse upstream snapshot ranks where lower is better (not dense 1..N positions); `dateAdded` and `lastModified` put newest first. |
| `includeLicense` | boolean | Enrich each family with license, license URL, copyright, source repository, source date, languages, unicode coverage, and description. Uses the per-family metadata endpoint, then METADATA.pb, then the download manifest. |
| `includeFiles` | boolean | Fetch the full CSS2 stylesheet (woff2/unicode-range) and the download manifest (TTF URLs). Capped by `maxFilesPerFamily`. CSS2 output depends on the user agent: the actor requests a modern Chrome UA and retries once with Safari when Chrome receives only TTF. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "byFamily",
  "families": [
    "Roboto"
  ],
  "category": "Sans Serif",
  "maxItems": 3,
  "variableOnly": false,
  "colorOnly": false,
  "brandOnly": false,
  "notoOnly": false,
  "sortBy": "default",
  "includeLicense": false,
  "includeFiles": false,
  "maxFilesPerFamily": 10
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~google-fonts-library-metadata-extractor/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/nimbryxo-studio~google-fonts-library-metadata-extractor/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `family`, `category`, `isVariable`, `weights`, `subsets`, `designers`, `popularity`, `trending`, `dateAdded`, `license`, `googleFontsUrl`, `css2UrlFull`, `fileCount`, `name`, `codepointHex`, `categories`, `tags`, `sizesPx`, `supportedFamilies`, `version`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.