# USACE Wetland Permit Geofence Watcher (`mikechiou/wetland-clean-water-permits`) Actor Monitor public USACE wetland and Clean Water Act public notices near geofences, watersheds, counties, applicants, and comment deadlines. - **URL**: https://apify.com/mikechiou/wetland-clean-water-permits.md - **Developed by:** [Mike Chiou](https://apify.com/mikechiou) (community) - **Categories:** Agents, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $60.00 / 1,000 geofence public notice matches 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## USACE Wetland Permit Geofence Watcher Monitor public USACE wetland and Clean Water Act public notices for projects near watched sites, watersheds, counties, applicants, and comment deadlines. This Actor turns the public USACE Regulatory Request System public-notice feed into normalized events that are easier for due-diligence tools, land teams, environmental consultants, legal teams, lenders, and AI agents to consume. ### What It Does - Searches the public USACE RRS public-notice API. - Fetches each notice detail before emitting results. - Matches notices against watched geofences, states, districts, counties, HUC codes, applicants, action types, and project terms. - Emits deterministic comment-deadline alerts for notices accepting public comments. - Includes source links and API provenance on every record. - Deduplicates repeated runs with a named key-value store. ### Inputs | Input | Purpose | | ------------------- | -------------------------------------------------------------------------------------------------------------------- | | `searchText` | Text sent to the RRS search endpoint. Default is `wetland`; set an empty string to search all active public notices. | | `geofences` | Up to 10 `{ lat, lon, radiusKm, label }` circles. | | `states` | Two-letter state filters. | | `districtCodes` | USACE district code filters such as `SAJ` or `NAO`. | | `counties` | County names or fragments. | | `hucCodes` | HUC prefixes or full HUC codes. | | `actionTypes` | Exact action types such as `SP` or `DEVMBA`. | | `applicantKeywords` | Word-boundary applicant/company terms. | | `projectKeywords` | Word-boundary project, keyword, or description terms. | | `dateWindow` | Public-notice-start date window. Default is 30 days. | | `commentWindowDays` | Emits deadline alerts for matched notices closing within this many days. | ### Output Events | Event | When It Emits | | ------------------------------ | ------------------------------------------------------------------------- | | `geofence_public_notice_match` | A public notice falls inside a watched geofence after filters. | | `new_public_notice` | A public notice matches non-geofence filters, or no geofence is supplied. | | `comment_deadline_alert` | A matched accepting-comments notice closes within `commentWindowDays`. | Every event includes: - `source_notice_url` - `source_api_url` - `entities` with DA number, district, action type, applicant, HUC, county, and state - `dates` with public notice start, comments end, and days remaining - `location` with latitude, longitude, and `coordinates_basis` - `matched_geofences` - `matched_dimensions` - `match_terms` - raw source notice payload ### Example ```json { "searchText": "wetland", "geofences": [ { "label": "St. Johns Airport", "lat": 29.96812, "lon": -81.34483, "radiusKm": 5 } ], "states": ["FL"], "hucCodes": ["03080201"], "projectKeywords": ["Section 404"], "commentWindowDays": 7, "maxSourceNotices": 25, "maxEvents": 10 } ```` ### Pricing Pay per event: - `geofence_public_notice_match`: $0.06 - `new_public_notice`: $0.04 - `comment_deadline_alert`: $0.03 No events are charged for unmatched source records, duplicate events, or empty runs. ### Limitations - This Actor uses public USACE RRS JSON endpoints. It is not affiliated with USACE. - Coordinates are source-provided and may be sparse or approximate. Check `coordinates_basis`. - Public notice links may point to district pages or PDFs maintained outside RRS. - The default search text is `wetland`; set it to an empty string to search all active public notices. - This is an informational monitoring feed, not wetland delineation, environmental, legal, permitting, lending, or compliance advice. ### Maintenance The live canary searches `wetland`, fetches detail records, and verifies DA numbers, comment dates, coordinates, and provenance. If the RRS API changes shape or starts returning an access page, the canary fails loudly so the maintainer can patch or pause the Actor. # Actor input Schema ## `searchText` (type: `string`): Text sent to the public USACE RRS search endpoint. Default keeps v1 focused on wetland notices; use an empty string to search all active public notices. ## `geofences` (type: `array`): Up to 10 watched circles. A notice produces geofence\_public\_notice\_match when its coordinates fall within any circle. ## `states` (type: `array`): Optional two-letter state filters. These are sent to the RRS search endpoint and verified again in output matching. ## `districtCodes` (type: `array`): Optional exact district codes, e.g. SAJ, NAO, LRP. ## `counties` (type: `array`): Optional county names or fragments, e.g. St. Johns, Westmoreland. ## `hucCodes` (type: `array`): Optional hydrologic unit code prefixes or full codes. A prefix such as 0308 matches 03080201. ## `actionTypes` (type: `array`): Optional exact USACE action types, e.g. SP or DEVMBA. ## `applicantKeywords` (type: `array`): Optional applicant or applicant-company keywords matched with word boundaries. ## `projectKeywords` (type: `array`): Optional project, keyword, or description terms matched with word boundaries. ## `dateWindow` (type: `object`): Use explicit start/end ISO dates or lookbackDays. Default is a 30-day lookback against the public notice start date. ## `commentWindowDays` (type: `integer`): Emit comment\_deadline\_alert when an accepting-comments notice closes within this many days. Use 0 to disable. ## `includeExpiredCommentWindows` (type: `boolean`): When false, notices whose comment windows have already expired are skipped. ## `maxSourceNotices` (type: `integer`): Safety cap for RRS detail fetches before local matching. ## `maxEvents` (type: `integer`): Safety cap for one run. ## `stateStoreName` (type: `string`): Named key-value store used for dedupe and notice snapshots. Use **RUN\_DEFAULT** to keep state in the default store for each run. ## Actor input object example ```json { "searchText": "wetland", "geofences": [ { "label": "St. Johns Airport", "lat": 29.96812, "lon": -81.34483, "radiusKm": 5 } ], "states": [ "FL" ], "districtCodes": [], "counties": [], "hucCodes": [ "03080201" ], "actionTypes": [], "applicantKeywords": [], "projectKeywords": [ "Section 404" ], "dateWindow": { "lookbackDays": 30 }, "commentWindowDays": 7, "includeExpiredCommentWindows": false, "maxSourceNotices": 25, "maxEvents": 10, "stateStoreName": "wetland-clean-water-permits-state" } ``` # Actor output Schema ## `results` (type: `string`): No description ## `summary` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchText": "wetland", "geofences": [ { "label": "St. Johns Airport", "lat": 29.96812, "lon": -81.34483, "radiusKm": 5 } ], "states": [ "FL" ], "districtCodes": [], "counties": [], "hucCodes": [ "03080201" ], "actionTypes": [], "applicantKeywords": [], "projectKeywords": [ "Section 404" ], "dateWindow": { "lookbackDays": 30 }, "commentWindowDays": 7, "maxSourceNotices": 25, "maxEvents": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("mikechiou/wetland-clean-water-permits").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchText": "wetland", "geofences": [{ "label": "St. Johns Airport", "lat": 29.96812, "lon": -81.34483, "radiusKm": 5, }], "states": ["FL"], "districtCodes": [], "counties": [], "hucCodes": ["03080201"], "actionTypes": [], "applicantKeywords": [], "projectKeywords": ["Section 404"], "dateWindow": { "lookbackDays": 30 }, "commentWindowDays": 7, "maxSourceNotices": 25, "maxEvents": 10, } # Run the Actor and wait for it to finish run = client.actor("mikechiou/wetland-clean-water-permits").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchText": "wetland", "geofences": [ { "label": "St. Johns Airport", "lat": 29.96812, "lon": -81.34483, "radiusKm": 5 } ], "states": [ "FL" ], "districtCodes": [], "counties": [], "hucCodes": [ "03080201" ], "actionTypes": [], "applicantKeywords": [], "projectKeywords": [ "Section 404" ], "dateWindow": { "lookbackDays": 30 }, "commentWindowDays": 7, "maxSourceNotices": 25, "maxEvents": 10 }' | apify call mikechiou/wetland-clean-water-permits --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=mikechiou/wetland-clean-water-permits", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "USACE Wetland Permit Geofence Watcher", "description": "Monitor public USACE wetland and Clean Water Act public notices near geofences, watersheds, counties, applicants, and comment deadlines.", "version": "0.1", "x-build-id": "WnPYGafsJftceuRl4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mikechiou~wetland-clean-water-permits/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mikechiou-wetland-clean-water-permits", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/mikechiou~wetland-clean-water-permits/runs": { "post": { "operationId": "runs-sync-mikechiou-wetland-clean-water-permits", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/mikechiou~wetland-clean-water-permits/run-sync": { "post": { "operationId": "run-sync-mikechiou-wetland-clean-water-permits", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchText": { "title": "Source search text", "type": "string", "description": "Text sent to the public USACE RRS search endpoint. Default keeps v1 focused on wetland notices; use an empty string to search all active public notices.", "default": "wetland" }, "geofences": { "title": "Geofences", "maxItems": 10, "type": "array", "description": "Up to 10 watched circles. A notice produces geofence_public_notice_match when its coordinates fall within any circle.", "items": { "type": "object", "required": [ "lat", "lon", "radiusKm" ], "properties": { "label": { "type": "string", "title": "Label", "description": "Optional label shown in matched output." }, "lat": { "type": "number", "title": "Latitude", "description": "Circle center latitude in decimal degrees.", "minimum": -90, "maximum": 90 }, "lon": { "type": "number", "title": "Longitude", "description": "Circle center longitude in decimal degrees.", "minimum": -180, "maximum": 180 }, "radiusKm": { "type": "number", "title": "Radius in km", "description": "Circle radius in kilometers. Boundary matches are included.", "minimum": 0 } } } }, "states": { "title": "States", "type": "array", "description": "Optional two-letter state filters. These are sent to the RRS search endpoint and verified again in output matching.", "items": { "type": "string" } }, "districtCodes": { "title": "USACE district codes", "type": "array", "description": "Optional exact district codes, e.g. SAJ, NAO, LRP.", "items": { "type": "string" } }, "counties": { "title": "Counties", "type": "array", "description": "Optional county names or fragments, e.g. St. Johns, Westmoreland.", "items": { "type": "string" } }, "hucCodes": { "title": "HUC codes", "type": "array", "description": "Optional hydrologic unit code prefixes or full codes. A prefix such as 0308 matches 03080201.", "items": { "type": "string" } }, "actionTypes": { "title": "Action types", "type": "array", "description": "Optional exact USACE action types, e.g. SP or DEVMBA.", "items": { "type": "string" } }, "applicantKeywords": { "title": "Applicant keywords", "type": "array", "description": "Optional applicant or applicant-company keywords matched with word boundaries.", "items": { "type": "string" } }, "projectKeywords": { "title": "Project keywords", "type": "array", "description": "Optional project, keyword, or description terms matched with word boundaries.", "items": { "type": "string" } }, "dateWindow": { "title": "Public notice start window", "type": "object", "description": "Use explicit start/end ISO dates or lookbackDays. Default is a 30-day lookback against the public notice start date.", "properties": { "start": { "type": "string", "title": "Start date", "description": "Inclusive public-notice-start window start in YYYY-MM-DD format." }, "end": { "type": "string", "title": "End date", "description": "Inclusive public-notice-start window end in YYYY-MM-DD format." }, "lookbackDays": { "type": "integer", "title": "Lookback days", "description": "Rolling window size when start/end are omitted.", "minimum": 1, "maximum": 30 } } }, "commentWindowDays": { "title": "Comment deadline window", "minimum": 0, "maximum": 30, "type": "integer", "description": "Emit comment_deadline_alert when an accepting-comments notice closes within this many days. Use 0 to disable.", "default": 7 }, "includeExpiredCommentWindows": { "title": "Include expired comment windows", "type": "boolean", "description": "When false, notices whose comment windows have already expired are skipped.", "default": false }, "maxSourceNotices": { "title": "Maximum source notices", "minimum": 1, "maximum": 250, "type": "integer", "description": "Safety cap for RRS detail fetches before local matching.", "default": 75 }, "maxEvents": { "title": "Maximum events", "minimum": 1, "maximum": 250, "type": "integer", "description": "Safety cap for one run.", "default": 50 }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Named key-value store used for dedupe and notice snapshots. Use __RUN_DEFAULT__ to keep state in the default store for each run.", "default": "wetland-clean-water-permits-state" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```