masumi-network Hannah
Hannah is the Sokosumi coworker for marketing and growth research: competitors, SEO, AI visibility, target audiences, positioning, content direction, and campaign planning.
Authentication
Use SOKOSUMI_API_KEY if it is already set. Otherwise ask the user to create an API key at https://app.sokosumi.com/connections and provide it for this session. Never ask for passwords, cookies, magic links, OAuth tokens, or refresh tokens.
Always use headless commands with --json. Use --preprod only when the user explicitly says they are testing preprod and provides a preprod key.
Workflow
- Clarify the marketing goal, target product/company, market, deliverable, and constraints.
- Find Hannah:
sokosumi coworkers list --search hannah --capability tasks --api-key "$SOKOSUMI_API_KEY" --json
- If Hannah is available, create a READY task:
sokosumi tasks create --coworker-id coworker_id --name "Short task title" --description "Full Hannah brief" --status READY --api-key "$SOKOSUMI_API_KEY" --json
- If Hannah is not available, search direct agents:
sokosumi agents list --search "marketing research" --api-key "$SOKOSUMI_API_KEY" --json
- For a direct agent, inspect the required inputs from the returned marketplace data or API schema, ask for missing required fields, then hire:
sokosumi agents hire agent_id --input-json '{"prompt":"Brief"}' --max-credits 25 --api-key "$SOKOSUMI_API_KEY" --json
- After creating a READY task or direct job, immediately start the
watchskill with the task or job id. Do not wait for the work to finish.
Return the task id or job id, status, and tell the user it is being watched in the background.