mediawiki_find_replace
Find and replace text on a single wiki page. Supports regex, replacement of all occurrences, and preview before saving.
Instructions
PREFERRED for simple text changes on a single page.
USE WHEN: User says "replace X with Y", "fix the typo", "change the version number", "update the name".
NOT FOR: Creating/rewriting pages (use mediawiki_edit_page). Not for multi-page updates (use mediawiki_bulk_replace). Not for formatting (use mediawiki_apply_formatting).
PARAMETERS:
title: Page name (required)
find: Text to find (required)
replace: Replacement text (required)
all: Replace all occurrences (default false = first only)
use_regex: Treat find as regex (default false)
preview: Preview changes without saving (default true for safety)
summary: Edit summary
RETURNS: Match count and preview of changes. Set preview=false to apply. Includes revision ID, diff URL, and undo instructions.
NOTE: Requires authentication (bot password) to apply changes. Anonymous sessions cannot edit.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | Replace all occurrences (default: first only) | |
| find | Yes | Text to find (exact match or regex if use_regex=true) | |
| minor | No | Mark as minor edit | |
| title | Yes | Page title to edit | |
| preview | No | Preview changes without saving | |
| replace | Yes | Replacement text | |
| summary | No | Edit summary | |
| rationale | Yes | Required one-sentence explanation of why you are making this change. Stored in the audit log for post-hoc intent reconstruction. | |
| use_regex | No | Treat 'find' as a Go RE2 regex. Characters like . [ ] * + ? ( ) have special meaning; escape with backslash for literal match. Max 500 chars. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| undo | No | ||
| title | Yes | ||
| changes | No | ||
| message | Yes | ||
| preview | Yes | ||
| success | Yes | ||
| revision | No | ||
| match_count | Yes | ||
| revision_id | No | ||
| replace_count | Yes |