files

mcp/QUICK_REFERENCE.md

@@ -0,0 +1,96 @@
+# Cremote MCP Tools - Quick Reference
+
+## Tool Names
+- `web_navigate_cremotemcp` - Navigate to URLs
+- `web_interact_cremotemcp` - Interact with elements
+- `web_extract_cremotemcp` - Extract page data
+- `web_screenshot_cremotemcp` - Take screenshots
+- `web_manage_tabs_cremotemcp` - Manage browser tabs
+- `web_iframe_cremotemcp` - Switch iframe context
+
+## Essential Parameters
+
+### web_navigate_cremotemcp
+```yaml
+url: "https://example.com"        # Required
+screenshot: true                  # Optional, default false
+timeout: 10                      # Optional, default 5 seconds
+```
+
+### web_interact_cremotemcp
+```yaml
+action: "click"                  # Required: click|fill|submit|upload
+selector: "button.submit"        # Required: CSS selector
+value: "text to fill"           # Required for fill/upload actions
+timeout: 10                     # Optional, default 5 seconds
+```
+
+## Common Patterns
+
+### Navigate + Screenshot
+```yaml
+web_navigate_cremotemcp:
+  url: "https://example.com"
+  screenshot: true
+```
+
+### Fill Form Field
+```yaml
+web_interact_cremotemcp:
+  action: "fill"
+  selector: "input[name='email']"
+  value: "user@example.com"
+```
+
+### Click Button
+```yaml
+web_interact_cremotemcp:
+  action: "click"
+  selector: "button#submit"
+```
+
+### Submit Form
+```yaml
+web_interact_cremotemcp:
+  action: "submit"
+  selector: "form"
+```
+
+### Upload File
+```yaml
+web_interact_cremotemcp:
+  action: "upload"
+  selector: "input[type='file']"
+  value: "/path/to/file.pdf"
+```
+
+## Best CSS Selectors
+
+✅ **Good:**
+- `#unique-id`
+- `input[name='fieldname']`
+- `button.primary-submit`
+- `form#login-form`
+
+❌ **Avoid:**
+- `div` (too generic)
+- `input` (too broad)
+- `:nth-child(3)` (fragile)
+
+## Typical Workflow
+
+1. **Navigate** to target page
+2. **Fill** required form fields
+3. **Click** submit buttons
+4. **Take screenshots** for verification
+5. **Navigate** to next page if needed
+
+## Error Handling
+
+- **Element not found**: Check CSS selector
+- **Timeout**: Increase timeout parameter
+- **Navigation failed**: Verify URL accessibility
+
+## Screenshots
+
+Screenshots are automatically saved to `/tmp/navigate-{timestamp}.png` when requested.