# Send Foxreach to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "foxreach",
    "name": "Foxreach",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/concaption/foxreach",
    "canonicalUrl": "https://clawhub.ai/concaption/foxreach",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/foxreach",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=foxreach",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "api-reference.md",
      "examples.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "foxreach",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T03:27:59.179Z",
      "expiresAt": "2026-05-07T03:27:59.179Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=foxreach",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=foxreach",
        "contentDisposition": "attachment; filename=\"foxreach-0.1.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "foxreach"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/foxreach"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/foxreach",
    "downloadUrl": "https://openagent3.xyz/downloads/foxreach",
    "agentUrl": "https://openagent3.xyz/skills/foxreach/agent",
    "manifestUrl": "https://openagent3.xyz/skills/foxreach/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/foxreach/agent.md"
  }
}
```
## Documentation

### FoxReach API Management Skill

You are managing the FoxReach cold email outreach platform through its Python SDK and CLI. This skill covers all API operations for leads, campaigns, sequences, templates, email accounts, inbox, and analytics.

### Setup & Authentication

The Python SDK is at integrations/sdk-python/ and the CLI is at integrations/cli/. Both use API key authentication with keys prefixed otr_.

Check if the SDK is available:

python -c "from foxreach import FoxReach; print('SDK ready')"

If not installed, install it:

cd integrations/sdk-python && pip install -e .

Authentication — Always get the API key from the user or environment before making calls. Never hardcode keys. Use environment variable injection:

FOXREACH_API_KEY=otr_... python script.py

Or use the CLI config:

cd integrations/cli && PYTHONPATH=. python -m foxreach_cli.main config set-key --key otr_...

### How to Execute Operations

Write inline Python scripts using the SDK. Always follow this pattern:

import json
from foxreach import FoxReach

client = FoxReach(api_key="otr_USER_KEY_HERE")

# ... perform operation ...

client.close()

For quick operations, use one-liners:

python -c "
from foxreach import FoxReach
client = FoxReach(api_key='otr_...')
result = client.leads.list(page_size=10)
for lead in result:
    print(f'{lead.id}  {lead.email}  {lead.status}')
print(f'Total: {result.meta.total}')
client.close()
"

### Resource Reference

For complete API details, see api-reference.md.
For usage examples of every operation, see examples.md.

### Leads

ActionMethodNotesListclient.leads.list(page=1, page_size=50, search=..., status=..., tags=...)Paginated, filterableGetclient.leads.get(lead_id)Returns single LeadCreateclient.leads.create(LeadCreate(email=..., first_name=..., ...))Deduplicates by emailUpdateclient.leads.update(lead_id, LeadUpdate(company=..., ...))Partial updateDeleteclient.leads.delete(lead_id)Soft-delete

### Campaigns

ActionMethodNotesListclient.campaigns.list(status=...)Filter by draft/active/paused/completedGetclient.campaigns.get(campaign_id)Includes statsCreateclient.campaigns.create(CampaignCreate(name=..., ...))Creates in draftUpdateclient.campaigns.update(campaign_id, CampaignUpdate(...))Can't edit if activeDeleteclient.campaigns.delete(campaign_id)Must be draftStartclient.campaigns.start(campaign_id)Transitions to activePauseclient.campaigns.pause(campaign_id)Pauses sendingAdd Leadsclient.campaigns.add_leads(campaign_id, [lead_ids])Bulk addAdd Accountsclient.campaigns.add_accounts(campaign_id, [account_ids])Assign senders

### Sequences (nested under campaigns)

ActionMethodNotesListclient.campaigns.sequences.list(campaign_id)All stepsCreateclient.campaigns.sequences.create(campaign_id, SequenceCreate(body=..., ...))Add stepUpdateclient.campaigns.sequences.update(campaign_id, seq_id, SequenceUpdate(...))Edit stepDeleteclient.campaigns.sequences.delete(campaign_id, seq_id)Remove step

### Templates

ActionMethodNotesListclient.templates.list()PaginatedGetclient.templates.get(template_id)Single templateCreateclient.templates.create(TemplateCreate(name=..., body=...))New templateUpdateclient.templates.update(template_id, TemplateUpdate(...))Partial updateDeleteclient.templates.delete(template_id)Remove

### Email Accounts

ActionMethodNotesListclient.email_accounts.list()PaginatedGetclient.email_accounts.get(account_id)With health metricsDeleteclient.email_accounts.delete(account_id)Remove

### Inbox

ActionMethodNotesList Threadsclient.inbox.list_threads(category=..., is_read=..., ...)FilterableGetclient.inbox.get(reply_id)Full threadUpdateclient.inbox.update(reply_id, ThreadUpdate(is_read=..., ...))Mark read/starred

### Analytics

ActionMethodNotesOverviewclient.analytics.overview()Dashboard KPIsCampaignclient.analytics.campaign(campaign_id)Metrics + daily stats

### Pagination

List endpoints return PaginatedResponse objects:

result = client.leads.list(page=1, page_size=50, search="acme")

# Access data
for lead in result:
    print(lead.email)

# Check pagination info
print(f"Page {result.meta.page}/{result.meta.total_pages}, {result.meta.total} total")

# Get next page
if result.has_next_page():
    next_result = result.next_page()

# Auto-paginate through ALL results
for lead in client.leads.list().auto_paging_iter():
    print(lead.email)

### Error Handling

Always wrap API calls in try/except:

from foxreach import FoxReach, NotFoundError, RateLimitError, AuthenticationError, FoxReachError

try:
    lead = client.leads.get("cld_nonexistent")
except NotFoundError:
    print("Lead not found")
except AuthenticationError:
    print("Invalid API key")
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except FoxReachError as e:
    print(f"API error: {e}")

### Template Variables & Personalization

Email bodies support variable substitution using {{variable}} syntax:

{{firstName}}, {{lastName}}, {{email}}
{{company}}, {{title}}, {{phone}}
{{website}}, {{linkedinUrl}}
Custom fields: {{customFieldName}}

Spintax is also supported: {Hi|Hey|Hello} {{firstName}}

### 1. Full Campaign Setup

When the user wants to set up a complete campaign, follow these steps in order:

Create the campaign with campaigns.create()
Add sequence steps with campaigns.sequences.create() for each email in the chain
Add leads with campaigns.add_leads()
Assign email accounts with campaigns.add_accounts()
Start the campaign with campaigns.start()

### 2. Check Campaign Performance

Get campaign analytics with analytics.campaign(id)
Show sent, delivered, bounced, replied, opened stats
Show reply rate and bounce rate
If daily_stats are available, summarize trends

### 3. Manage Inbox

List unread threads with inbox.list_threads(is_read=False)
Categorize replies by updating with inbox.update(id, ThreadUpdate(category="interested"))
Common categories: interested, not_interested, out_of_office, wrong_person, unsubscribe

### 4. Bulk Lead Import

For adding multiple leads, create them one by one (the API deduplicates by email):

leads_data = [
    {"email": "a@example.com", "first_name": "Alice", "company": "Acme"},
    {"email": "b@example.com", "first_name": "Bob", "company": "Beta"},
]
created = []
for data in leads_data:
    lead = client.leads.create(LeadCreate(**data))
    created.append(lead)
    print(f"Created: {lead.id} - {lead.email}")

### Important Notes

Base URL: https://api.foxreach.io/api/v1
Rate limit: 100 requests per minute. The SDK auto-retries on 429.
ID prefixes: Leads cld_, Campaigns cmp_, Replies rpl_, Templates tpl_
Timezone: All datetimes in UTC ISO 8601 format.
Sending days: Array of integers, 1=Monday through 7=Sunday.
Sending hours: 0-23 range, in the campaign's timezone.
Campaign status flow: draft → active → paused → active → completed
Soft deletes: Leads are soft-deleted and can reappear on re-import.
Always confirm with the user before destructive operations (delete, start campaign).
When listing data, default to showing a formatted summary, not raw JSON.
When creating resources, confirm the details with the user before executing.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: concaption
- Version: 0.1.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T03:27:59.179Z
- Expires at: 2026-05-07T03:27:59.179Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/foxreach)
- [Send to Agent page](https://openagent3.xyz/skills/foxreach/agent)
- [JSON manifest](https://openagent3.xyz/skills/foxreach/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/foxreach/agent.md)
- [Download page](https://openagent3.xyz/downloads/foxreach)