# Venture Opportunity Framing (`fifthrow/venture-opportunity-decision-framing`) Actor

Finds the new-business spaces where market signals meet a company's own assets and recommends which one to take into concept development. It maps the company's relevant assets and existing initiatives alongside customer problems, market shifts and... Returns HTML, Markdown, JSON, and dataset rows.

- **URL**: https://apify.com/fifthrow/venture-opportunity-decision-framing.md
- **Developed by:** [FifthRow](https://apify.com/fifthrow) (community)
- **Categories:** AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$14.06 / venture opportunity framing report

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

Finds the new-business spaces where market signals meet a company's own assets and recommends which one to take into concept development. It maps the company's relevant assets and existing initiatives alongside customer problems, market shifts and active players, then defines bounded spaces and rates each on customer need, attractiveness, crowding, feasibility, parent fit, novelty for the company and the stated venture ambition. The result is a ranked set of opportunity spaces with a recommended pick, the evidence behind it, route options and the first questions concept work must answer. It does not design the venture concept or business model.

You receive:

- A recommended opportunity space, with a runner-up and what would change the call
- A ranked table of every screened space with ratings and evidence confidence
- Space cards with customer problem, parent fit and build, partner or buy options

It returns a decision report in HTML, Markdown, JSON, and dataset rows.

### Runtime

Typical runtime: about 1 hour 7 minutes.

### Summary

Evaluate where market signals and {SIGNALS_AND_ASSETS} align to create new-business opportunities for {COMPANY} in {TARGET_GEOGRAPHY}, within the boundaries of {VENTURE_MANDATE}. The analysis examines customer problems, market shifts, active competitors, parent-company assets and existing initiatives to frame distinct opportunity spaces and identify potential overlap.

Receive a ranked opportunity table with evidence confidence, bounded space profiles, route options, and a recommendation on which space to advance into concept development. The decision brief compares the leading space with its runner-up, explains the whitespace and size of prize against the mandate, and identifies the key questions concept work must resolve. This gives venture leaders and sponsors a grounded basis for prioritizing where to focus next.

### Methodology

First, establish the scope using {COMPANY}, {SIGNALS_AND_ASSETS}, {TARGET_GEOGRAPHY}, and {VENTURE_MANDATE}. Review the company’s current assets, initiatives, published priorities, and ownership status, then map relevant customer problems, market shifts, and active players in the target geography. Use dated sources and distinguish evidence that directly measures a space from adjacent or broader-market context.

Frame distinct candidate spaces around customer segment, problem, use context, and boundary. For each, assess demand and willingness to pay, competitive crowding and whitespace, parent fit, existing-initiative overlap, and possible build, partner, or acquisition routes. Compare sourced revenue ranges with the mandate, rate each dimension on consistent qualitative scales, and calibrate confidence to evidence quality and scope. Apply mandate exclusions and reconcile conflicting facts before making the comparative assessment.

### Inputs

- `COMPANY` (text): Company. The parent company that would own the new venture, with its website. Example: ENGIE (engie.com)
- `SIGNALS_AND_ASSETS` (text): Signals And Assets. Where to look: the market signal or company asset area to explore, in a line or two; the App researches the assets and the evidence. Example: Flexibility assets at customer sites plus rising B2B demand for energy-as-a-service
- `TARGET_GEOGRAPHY` (text): Target Geography. Countries or regions where the venture would start. Example: France, Belgium, the Netherlands and Germany
- `VENTURE_MANDATE` (text): Venture Mandate. What the venture must achieve for the parent and what is off-limits. A line or two is enough; the App researches the rest. Example: EUR 50M revenue in 5 years, no residential retail

### Outputs

Finished runs write files to the Actor **key-value store**, plus tabular rows in the default dataset.

#### HTML report (`REPORT.html`)

A self-contained HTML brief for reading the result in a browser. Use this when you want the formatted decision output,
including headings, lists, and cited source links from the App run.

#### Markdown report (`REPORT.md`)

A portable markdown document with the same narrative as the HTML report. Use this when you want to paste the output
into docs, tickets, or another markdown editor without HTML chrome.

#### Structured JSON (`OUTPUT`)

Machine-readable JSON in the key-value store under the `OUTPUT` key. The object includes:

- `id`, `status`, `ready`: App run identity and completion state
- `title`, `catalog_url`: display title and FifthRow catalog URL
- `started_at`, `finished_at`, `duration_seconds`: run timing
- `summary`: executive summary text
- `company_impact`: implied impact narrative, when the App produced one
- `sections`: sectioned App results
- `answers`: visible answer objects (title, markdown, sources)
- `questions`: Q\&A objects produced by the run
- `sources`: deduplicated source URLs
- `dataset_items`: source rows for the default dataset (oversized dataset writes may omit markdown)
- `report_markdown`: full markdown body also stored as `REPORT.md`

#### Dataset rows

The default dataset stores rows (`run`, `summary`, `company_impact`, `answer`, `qna`)
with `title`, `markdown`, and `sources`. Rows that exceed the dataset item size limit are stored with empty markdown.

# Changelog

This Actor's version history is a separate document: https://apify.com/fifthrow/venture-opportunity-decision-framing/changelog.md

# Actor input Schema

## `COMPANY` (type: `string`):

The parent company that would own the new venture, with its website. Example: ENGIE (engie.com) Suggested examples: ENGIE; Siemens; Schneider Electric. Other clear text values are also accepted.

## `SIGNALS_AND_ASSETS` (type: `string`):

Where to look: the market signal or company asset area to explore, in a line or two; the App researches the assets and the evidence. Example: Flexibility assets at customer sites plus rising B2B demand for energy-as-a-service Suggested examples: Industrial heat electrification; Commercial building flexibility; EV fleet charging. Other clear text values are also accepted.

## `TARGET_GEOGRAPHY` (type: `string`):

Countries or regions where the venture would start. Example: France, Belgium, the Netherlands and Germany Suggested examples: France; Belgium; Netherlands. Other clear text values are also accepted.

## `VENTURE_MANDATE` (type: `string`):

What the venture must achieve for the parent and what is off-limits. A line or two is enough; the App researches the rest. Example: EUR 50M revenue in 5 years, no residential retail Suggested examples: EUR 50M revenue in five years; Positive EBITDA by year four; No residential retail customers. Other clear text values are also accepted.

## Actor input object example

```json
{
  "COMPANY": "ENGIE",
  "SIGNALS_AND_ASSETS": "Industrial heat electrification",
  "TARGET_GEOGRAPHY": "France",
  "VENTURE_MANDATE": "EUR 50M revenue in five years"
}
```

# Actor output Schema

## `OUTPUT` (type: `string`):

Complete structured JSON result stored as KVS OUTPUT.

## `markdown` (type: `string`):

Portable markdown report stored as KVS REPORT.md.

## `overview` (type: `string`):

Run overview plus summary, company impact, answers, and Q\&A as default dataset items.

## `report` (type: `string`):

Self-contained HTML report stored as KVS REPORT.html.

# 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 = {
    "COMPANY": "ENGIE",
    "SIGNALS_AND_ASSETS": "Industrial heat electrification",
    "TARGET_GEOGRAPHY": "France",
    "VENTURE_MANDATE": "EUR 50M revenue in five years"
};

// Run the Actor and wait for it to finish
const run = await client.actor("fifthrow/venture-opportunity-decision-framing").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 = {
    "COMPANY": "ENGIE",
    "SIGNALS_AND_ASSETS": "Industrial heat electrification",
    "TARGET_GEOGRAPHY": "France",
    "VENTURE_MANDATE": "EUR 50M revenue in five years",
}

# Run the Actor and wait for it to finish
run = client.actor("fifthrow/venture-opportunity-decision-framing").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 '{
  "COMPANY": "ENGIE",
  "SIGNALS_AND_ASSETS": "Industrial heat electrification",
  "TARGET_GEOGRAPHY": "France",
  "VENTURE_MANDATE": "EUR 50M revenue in five years"
}' |
apify call fifthrow/venture-opportunity-decision-framing --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,fifthrow/venture-opportunity-decision-framing"
        }
    }
}
```

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/kpnPHlZ9cWdxBLl5r/builds/xfCNWOVcPBE1JpPRv/openapi.json
