Skip to content

feat(web-security): self-contained Flareprox IP rotation tool and skill - #48

Merged
GangGreenTemperTatum merged 1 commit into
mainfrom
ads/cap-1014-integrate-flareprox-into-web-security-capability
Aug 26, 2026
Merged

feat(web-security): self-contained Flareprox IP rotation tool and skill#48
GangGreenTemperTatum merged 1 commit into
mainfrom
ads/cap-1014-integrate-flareprox-into-web-security-capability

Conversation

@GangGreenTemperTatum

@GangGreenTemperTatum GangGreenTemperTatum commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a KISS, self-contained Flareprox integration to the web-security capability. No external flareprox repo/binary is required — the tool deploys Cloudflare Workers directly via the Cloudflare REST API.

Pending MrTurvey/flareprox#9 prior to merging (so can carry auth)

What's included

  • capabilities/web-security/tools/flareprox.py — new Flareprox Toolset with:

    • flareprox_status — verify CF_API_TOKEN / CF_ACCOUNT_ID and count active workers
    • flareprox_create — deploy N Cloudflare Worker proxies
    • flareprox_list — list tracked workers
    • flareprox_proxy_url — round-robin worker URL for manual use
    • flareprox_request — send an HTTP request through a worker
    • flareprox_cleanup — delete all deployed workers
  • capabilities/web-security/skills/ip-rotation/SKILL.md — agent skill with:

    • Activation gate on IPROTATE_ENABLED
    • When to use / when not to use
    • Prerequisites and lifecycle examples
  • capabilities/web-security/agents/web-security.md — mention flareprox_* tools in the built-in tools list.

  • capabilities/web-security/capability.yaml — bump version to 1.1.3, update description, add keywords.

  • capabilities/web-security/tests/test_flareprox.py — mocked Cloudflare API tests.

  • capabilities/web-security/tests/conftest.py — extend the Toolset test stub to support pydantic-like **kwargs construction and model_post_init, so field-bearing Toolset subclasses can be unit-tested.

Design notes

  • Carries only the concept from the Claude Code harness (project-obsidian-md); no code or external dependency on ~/git/flareprox.
  • Worker script is embedded in the Python file, so it works in hosted sandboxes.
  • State persists to ~/.flareprox/workers.json.

Testing

python3 -m pytest capabilities/web-security/tests/test_flareprox.py -v

All 13 tests pass. The full web-security test suite (excluding test_bbscope.py which requires an optional bbscope module) also passes.

Deployment assumptions

  • Cloudflare account with workers.dev enabled.
  • CF_API_TOKEN with Workers Scripts edit permission.
  • CF_ACCOUNT_ID set.

@GangGreenTemperTatum
GangGreenTemperTatum marked this pull request as ready for review June 12, 2026 19:48
@GangGreenTemperTatum
GangGreenTemperTatum force-pushed the ads/cap-1014-integrate-flareprox-into-web-security-capability branch from 2580603 to 77fd71d Compare June 12, 2026 19:54
… skill

- Add flareprox.py toolset: deploys Cloudflare Worker proxies via REST API,
  routes requests through them, and cleans up workers when done. No external
  flareprox binary or repo required.
- Add ip-rotation skill with activation gate (IPROTATE_ENABLED), usage
  guidance, and lifecycle examples.
- Update agent prompt to mention flareprox_* tools.
- Update capability.yaml description/version/keywords.
- Add tests with mocked Cloudflare API.
- Extend conftest stub Toolset to support pydantic-like kwargs and
  model_post_init so field-bearing Toolset subclasses can be tested.
@GangGreenTemperTatum
GangGreenTemperTatum force-pushed the ads/cap-1014-integrate-flareprox-into-web-security-capability branch from 77fd71d to 07a0068 Compare August 26, 2026 14:14
@GangGreenTemperTatum
GangGreenTemperTatum merged commit c836584 into main Aug 26, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant