problem. mine
Find complaints in a market and rank them by the number of people who mention them. The scan runs in the background and returns evidence links.
800 credits. Per scan. 0 when the scan finds no problem.
Example prompt
Send this to your AI app when Heelo is connected:
Find the most common complaints of Shopify store owners about their analytics, with links to the posts.
Input fields
| Field | Type | Description |
|---|---|---|
action | "scan" | "result" | |
domain | string | The topic area to mine, e.g. 'tools for indie developers' |
query | string | Free text from ReAct or MCP: naming a job id reads that scan, else it is the domain |
sources | array of string | Some of github_issues, hacker_news, web_pages, app_pages, forums, reddit; default github_issues, hacker_news, web_pages, app_pages, forums, reddit. |
window_days | integer | |
min_mentions | integer | Minimum distinct authors per problem |
job_id | string |
Code
The call with the input fields that the tool needs. Set HEELO_API_KEY to your API key.
import os
import requests
response = requests.post(
"https://toolsprimitives.uk/v1/tools/problem.mine/invoke",
headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
json={"input": {
"domain": "analytics for Shopify store owners",
}},
timeout=120,
)
response.raise_for_status()
print(response.json())// Node.js 18 or newer, in an ES module.
const response = await fetch("https://toolsprimitives.uk/v1/tools/problem.mine/invoke", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HEELO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
input: {
"domain": "analytics for Shopify store owners"
},
}),
signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());