n8n-nodes-fastaf
v0.1.3
Published
FastAF community node for web scraping, Google search, AI extraction, and structured web data
Maintainers
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-fastafSee 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:localFor 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
- 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.
- In n8n, create a FastAF API credential and enter the key in its password-masked API Key field.
- 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
- Add a Manual Trigger or another source of input items.
- Add FastAF, select an operation and credential, and fill its fields.
- 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, upstreamstatusCode,contentType,creditsUsed, andcostVersion;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 ofdata).
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-clistarter conventions. npm run lintruns the official n8n linter, includingeslint-plugin-n8n-nodes-baseand community security rules.npm run scan:localcalls the official@n8n/scan-community-packageanalysis 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 testis offline: mock HTTP calls only. Real paid test evidence is indocs/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
- FastAF documentation
- FastAF OpenAPI
- Official n8n community-node starter
- n8n node development
- Support: [email protected]
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
- Website: fastaf.co
- x402 scraping API: pricing and 402 example
- Comparisons: vs SerpApi · vs Exa · vs Tavily · vs Firecrawl
