npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

n8n-nodes-fastaf

v0.1.3

Published

FastAF community node for web scraping, Google search, AI extraction, and structured web data

Readme

n8n-nodes-fastaf

This is an n8n community node for FastAF, a web scraping, search, and structured-data API. Use FastAF in an n8n workflow or as an AI Agent tool (usableAsTool: true).

n8n is a fair-code licensed workflow automation platform.

Status: published on npm as n8n-nodes-fastaf; not verified by n8n. Free tier: 2 free calls per account. This package integrates only FastAF. It has no runtime dependencies; n8n-workflow is a peer supplied by n8n.

Installation

In n8n (self-hosted), go to Settings → Community Nodes → Install and enter n8n-nodes-fastaf. Or install from npm in your n8n custom directory:

npm install n8n-nodes-fastaf

See n8n's community-node installation documentation. Free tier: 2 free calls per account.

To build from source:

npm ci
npm run lint
npm run build
npm test
npm run scan:local

For a self-hosted development instance, mount the contents of dist read-only into a custom-extension directory and set N8N_CUSTOM_EXTENSIONS to that directory. For example, the Docker test used /custom. Restart n8n, then add FastAF and create its credential. Credentials are loaded from dist/credentials and the node from dist/nodes/FastAf.

n8n registers directory-mounted custom nodes as CUSTOM.fastAf. After a normal community-package installation, the type is n8n-nodes-fastaf.fastAf. The example workflow uses the latter; when using a directory mount, recreate its three FastAF nodes in the editor or change only their type fields to CUSTOM.fastAf.

npm pack creates an installable local tarball without publishing anything. Availability on n8n Cloud depends on n8n verification.

Credentials

  1. Create an account at FastAF and obtain an API key in the dashboard. Free tier: 2 free calls per account (after email verification), sign up at fastaf.co.
  2. In n8n, create a FastAF API credential and enter the key in its password-masked API Key field.
  3. Select the credential on the FastAF node. The credential test sends GET https://api.fastaf.co/v1/usage, a read-only account request, not a paid scrape.

Credential implementation: FastAfApi in credentials/FastAfApi.credentials.ts; n8n credential identifier: fastAfApi. Authentication uses a Bearer header to the fixed https://api.fastaf.co origin. There is no configurable proxy/base URL, no direct environment or filesystem access in runtime code, and no credential/query logging. n8n stores credentials encrypted. Never put keys in workflow parameters, exported workflow files, Git, screenshots, or support tickets.

Operations

| Operation | API request | Main input | | --- | --- | --- | | Scrape | POST /v1/scrape | URL | | Search (SERP) | POST /v1/serp | Query | | Extract | POST /v1/scrape with ai_query | URL and extraction instructions | | Google Maps | POST /v1/maps | Query or Additional Fields → Place ID | | Amazon Search | POST /v1/amazon, resource=search | Query | | Amazon Product | POST /v1/amazon, resource=product | ASIN | | Amazon Offers | POST /v1/amazon, resource=offers | ASIN | | Amazon Bestsellers | POST /v1/amazon, resource=bestsellers | Optional category, URL, domain, and list type | | LinkedIn Profile | POST /v1/linkedin | LinkedIn Profile ID | | YouTube Search | POST /v1/youtube, resource=search | Search Query | | YouTube Transcript | POST /v1/youtube, resource=transcript | Video ID | | Google News | POST /v1/news | Query | | Google Shopping | POST /v1/shopping | Query | | Google Scholar | POST /v1/scholar | Query, citation ID, or cluster ID | | Google Jobs | POST /v1/jobs | Query | | Google AI Mode | POST /v1/ai | Query | | Walmart Search | POST /v1/walmart | Walmart search URL | | Zillow Listings | POST /v1/zillow | Zillow search URL | | eBay Search or Product | POST /v1/ebay | eBay search or item URL | | X Profile | POST /v1/x | Profile ID | | Screenshot | POST /v1/screenshot | URL | | Get Usage | GET /v1/usage | None |

These 22 operations cover all 16 main data endpoints in the public OpenAPI plus read-only account usage. Key management, credit purchases, payment protocols, and retired signup routes are intentionally not exposed as AI tools. FastAF has no standalone /v1/search or /v1/extract endpoint; the mappings above are deliberate.

Additional Fields exposes typed endpoint-specific options, such as country, language, page, search result count, rendering modes, and screenshot format. Invalid types, unsupported fields, missing identifiers, invalid enums, and conflicting options are rejected before making a request. Do not add arbitrary JSON properties to a workflow export to override endpoints or primary fields.

Usage and output

  1. Add a Manual Trigger or another source of input items.
  2. Add FastAF, select an operation and credential, and fill its fields.
  3. Execute once. Use expressions to map data from previous nodes.

For example, select Scrape, set URL to https://example.com/, and leave Additional Fields empty. This requests basic Markdown. For Search (SERP), use IANA example domains and set Number of Results to 3. For Extract, use the same URL and instructions asking for a JSON object with title and description.

examples/scrape-search-extract.json is an importable, secret-free workflow. Select a credential on each node before running it. Running this example makes three paid API requests. All retry settings in the example are disabled.

Each input item produces one output item, with:

  • operation, upstream statusCode, contentType, creditsUsed, and costVersion;
  • data: parsed JSON or returned text, without flattening arrays or splitting search results;
  • binary.data: n8n binary data for screenshots, PDFs, and other binary responses (instead of data).

Input/output item linking is preserved. JSON extraction is best-effort upstream AI output, not a guaranteed schema. Markdown and HTML are preserved as text even when the upstream content-type is imperfect. The node never invents a formats=json scrape option. Missing cost headers are represented as null.

Credit and safety limits

One API request per input item. No automatic pagination or API retry is implemented. n8n workflow-level retries, repeated manual executions, additional incoming items, and AI Agent tool loops can still spend more credits. Keep those features disabled or configure limits appropriately.

Basic scraping defaults explicitly to dynamic=false, premium=false, and Markdown, including on Booking.com where FastAF otherwise selects dynamic rendering. Basic extraction adds ai_query and normally costs 11 credits: 1 basic scrape + 10 AI credits. Standard SERP normally costs 5 credits; basic scrape normally costs 1 credit. Advanced search, premium/dynamic/challenge modes, country targeting, and summary output can change credit costs. Consult the live pricing page and OpenAPI; this node does not impose or promise a fixed price. The published sources disagree on YouTube transcript credit cost, so check actual billing headers rather than assuming a rate.

Use only public targets you are authorized to access. Use the dedicated Zillow and eBay operations rather than Scrape. FastAF does not support AI extraction on Reddit. Local/private URL literals and embedded URL credentials are rejected, but upstream FastAF remains responsible for DNS/redirect/private-network enforcement on fetched target URLs. API redirects are disabled to protect the Bearer credential.

Requests time out after 90 seconds. Empty responses, malformed declared JSON, and bodies larger than 8 MiB are rejected; the size check runs after the HTTP helper downloads the response. Timeouts, interrupted responses, or post-response validation failures may already have consumed credits. Authentication, balance, rate-limit, and upstream errors are summarized without raw request headers or secrets. With n8n's On Error → Continue, a failed input emits an error item; otherwise execution stops.

Compatibility and development

  • Tested with n8n 2.44.6 in the official Docker image and Node.js 24 for local development. Older n8n releases are not certified by this project.
  • TypeScript, MIT license, English interface/documentation, and the official @n8n/node-cli starter conventions.
  • npm run lint runs the official n8n linter, including eslint-plugin-n8n-nodes-base and community security rules.
  • npm run scan:local calls the official @n8n/scan-community-package analysis on both source and a freshly packed local npm artifact. The scanner's CLI accepts registry package names, not local folders; registry provenance checks require a future published version.
  • npm test is offline: mock HTTP calls only. Real paid test evidence is in docs/docker-test-results.json; do not repeat the completed live test without a new credit budget.

Runtime code imports only n8n-workflow. Build/test/scanning tools are development dependencies, not shipped runtime libraries. This is programmatic rather than declarative because it validates endpoint-specific input and normalizes text, JSON, and binary responses while preserving billing metadata and sanitizing failures.

Verification and future release

The package follows the current verification guidelines. It has not been submitted or verified. Publication/source-ownership/provenance checks cannot be completed solely against unpublished local code.

A future owner-authorized release must come from the public repository fastaf-co/n8n-nodes-fastaf, use GitHub Actions with npm provenance, and have matching repository/npm maintainer ownership. publishConfig.provenance is enabled for that future step. No release workflow is enabled here; the included CI only tests and packs the package. No npm publish, Git push, or secret commit was performed.

Resources and support

Version history

0.1.2

Removed the Google Trends operation (22 operations). README: npm installation instructions; free tier is 2 free calls per account.

0.1.0

Initial implementation with 23 operations, API-key credential testing, AI-tool support, typed options, binary output, and no runtime dependencies.

License

MIT — FastAF.

Learn more