ScopeQuote — Freelancer Project Pricing Calculator

ScopeQuote turns income goals, realistic capacity, project scope, revisions, contingency, rush, expenses, discounts, and platform fees into one deterministic project-price planning estimate. It makes no network requests and returns one result in the run's default dataset, making the interface suitable for humans, API clients, MCP tools, and agentic Actor discovery.

Use ScopeQuote when you need a fast, repeatable quote baseline for a freelance project. It runs as a finite Actor, requires no external credentials, and emits one structured result that can be consumed in Console, by API clients, or by agent workflows.

Input and output

All input fields are optional and have visible defaults in the Actor input schema. A run emits exactly one dataset record containing the quote, project floor, base and effective rates, adjusted hours, price components, a floor warning, a calculation-version label, and a clear planning-only disclaimer.

The calculator does not fetch market rates, convert currencies, provide legal, tax, accounting, financial, or negotiation advice, or promise a commercial outcome. The three-letter currency field is a label only.

Default input produces:

• base rate: 86.8636 USD
• project floor: 2955.15 USD
• quote: 3102.91 USD
• below project floor: false

Local verification

Requires Node.js 24 or later.

npm ci
npm test

The calculation runner is tested with an in-memory Actor adapter, so tests do not create an account, contact Apify, accept payment, or expose an inbound service. npm start uses the Apify SDK's local storage behavior and is not needed for the offline test suite.

For an SDK-level local smoke run, set CRAWLEE_STORAGE_DIR to a workspace-local test directory and make sure APIFY_IS_AT_HOME is absent. In SDK 3.7.2, merely setting APIFY_IS_AT_HOME to the strings 0 or false still selects platform mode and can cause an unauthenticated cloud-storage request.

Transparent pricing model

This Actor is designed for pay-per-event pricing with:

• the automatically managed apify-actor-start event at its documented default price;
• the synthetic apify-default-dataset-item event at the separately reviewed per-result price;
• no custom Actor.charge() call.

Each successful calculation pushes exactly one visible default-dataset item. The synthetic dataset event therefore maps one charge to one delivered result, while the Apify SDK/platform handles user spending limits and billing behavior. Keep usesStandbyMode false and use limited permissions so the Actor can meet the documented agentic-payment eligibility requirements.

The initial price is $0.01 per successful quote result plus Apify's managed Actor-start event. Each successful run creates exactly one billable result.

Privacy and operational properties

• No credentials, secrets, wallets, trackers, external APIs, web scraping, or customer contact details are used.
• Task names are accepted for calculation but are not repeated in the output.
• Unknown fields and out-of-range values fail closed.
• The container runs as an unprivileged user with a pinned Node version.
• No public inbound service is opened; this is a finite Actor run.

Authoritative references checked July 17, 2026

• Actor definition: https://docs.apify.com/actors/development/actor-definition
• Actor input schema: https://docs.apify.com/actors/development/actor-definition/input-schema/specification/v1
• Actor output schema: https://docs.apify.com/actors/development/actor-definition/output-schema
• Dataset schema: https://docs.apify.com/storage/dataset-schema
• Pay per event: https://docs.apify.com/actors/publishing/monetize/pay-per-event
• Pricing and costs: https://docs.apify.com/actors/publishing/monetize/pricing-and-costs
• Agentic x402 eligibility: https://docs.apify.com/integrations/x402
• General Terms: https://docs.apify.com/legal/general-terms-and-conditions
• Store Publishing Terms: https://docs.apify.com/legal/store-publishing-terms-and-conditions