yujunjun/firecrawl
1
0
Fork 0
mirror of https://github.com/mendableai/firecrawl.git synced 2025-12-06 20:12:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update CLI help structure and add comprehensive argument examples

Browse Source 
- Improve CLI help structure with cleaner usage line and organized argument groups
- Add comprehensive examples for all CLI arguments in README
- Enhanced documentation with practical usage patterns for each feature
This commit is contained in:
mavrick-1 2025-09-17 13:59:28 +05:30
parent 8a0810e770
commit 01601e797a
2 changed files with 84 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
examples/gemini-2.5-screenshot-editor/README.md
View File

@ -63,6 +63,58 @@ python cli.py --generate "A futuristic dashboard with neon colors"
## 📚 Comprehensive Examples ## 📚 Comprehensive Examples
### 🎯 Basic Argument Examples
```bash
# --edit: Custom transformation
python cli.py https://github.com --edit "Make it look like a cyberpunk interface"
# --style: Preset style
python cli.py https://stripe.com --style vintage
# --artistic: Famous art style
python cli.py https://apple.com --artistic van_gogh
# --generate: Text-to-image (no URL needed)
python cli.py --generate "Modern e-commerce website with dark theme"
# --mobile: Mobile viewport
python cli.py https://tailwindcss.com --mobile
# --viewport-only: No scrolling
python cli.py https://example.com --viewport-only
# --output: Custom filename
python cli.py https://site.com --style cyberpunk --output my_result.png
# --verbose: Debug information
python cli.py https://github.com --artistic monet --verbose
# --high-quality: Maximum quality
python cli.py https://portfolio.com --edit "Make artistic" --high-quality
# --refine: Step-by-step improvements
python cli.py https://example.com --refine "Add dark theme" "Add neon accents"
# --composite: Combine multiple sites
python cli.py https://github.com https://gitlab.com --composite "Merge these designs"
# --batch: Process multiple URLs
python cli.py --batch urls.txt --style cyberpunk
# --save-intermediates: Save each refinement step
python cli.py https://site.com --refine "Step 1" "Step 2" --save-intermediates
# --output-dir: Custom directory for outputs
python cli.py --batch urls.txt --artistic monet --output-dir art_gallery
# --preserve-content: Keep original layout
python cli.py https://apple.com --artistic van_gogh --preserve-content
# --wait: Wait before screenshot
python cli.py https://slow-site.com --wait 10 --style minimal
```
### 🎨 Artistic Style Transfer ### 🎨 Artistic Style Transfer
Transform website screenshots into famous art styles: Transform website screenshots into famous art styles:

55
examples/gemini-2.5-screenshot-editor/cli.py
View File

@ -459,7 +459,9 @@ def validate_environment():
def main(): def main():
"""Enhanced CLI with all features.""" """Enhanced CLI with all features."""
parser = argparse.ArgumentParser( parser = argparse.ArgumentParser(
description="Advanced Firecrawl + Gemini 2.5 Flash Image CLI", prog='cli.py',
usage='%(prog)s [URL] [MODE] [OPTIONS]',
description="Firecrawl + Gemini 2.5 Flash Image CLI - Transform website screenshots with AI",
formatter_class=argparse.RawDescriptionHelpFormatter, formatter_class=argparse.RawDescriptionHelpFormatter,
epilog=""" epilog="""
EXAMPLES: EXAMPLES:
@ -507,43 +509,50 @@ PRESET STYLES:
# Main input arguments # Main input arguments
parser.add_argument('urls', nargs='*', help='Website URLs or image files') parser.add_argument('urls', nargs='*', help='Website URLs or image files')
# Operation modes # Operation modes (mutually exclusive)
mode_group = parser.add_mutually_exclusive_group() mode_group = parser.add_mutually_exclusive_group()
mode_group.add_argument('--generate', metavar='PROMPT', mode_group.add_argument('--generate', metavar='PROMPT',
help='Generate image from text prompt') help='Generate image from text prompt')
mode_group.add_argument('--style', choices=['cyberpunk', 'vintage', 'artistic', 'dramatic', 'minimal'], mode_group.add_argument('--style',
help='Apply preset style to screenshot') choices=['cyberpunk', 'vintage', 'artistic', 'dramatic', 'minimal'],
mode_group.add_argument('--artistic', choices=list(FirecrawlGeminiEditor.ARTISTIC_STYLES.keys()), help='Apply preset style')
help='Apply artistic style transfer') mode_group.add_argument('--artistic',
choices=['van_gogh', 'monet', 'picasso', 'warhol', 'dali',
'ukiyo_e', 'watercolor', 'oil_painting', 'pencil_sketch', 'comic_book'],
help='Apply artistic style')
mode_group.add_argument('--edit', metavar='PROMPT', mode_group.add_argument('--edit', metavar='PROMPT',
help='Custom editing instruction') help='Custom editing instruction')
mode_group.add_argument('--composite', metavar='PROMPT', mode_group.add_argument('--composite', metavar='PROMPT',
help='Combine multiple images/URLs') help='Combine multiple images')
mode_group.add_argument('--refine', nargs='+', metavar='STEP', mode_group.add_argument('--refine', nargs='+', metavar='STEP',
help='Apply iterative refinements') help='Apply step-by-step refinements')
# Input/Output options # Input/Output options
parser.add_argument('--output', '-o', help='Output filename') io_group = parser.add_argument_group('Input/Output')
parser.add_argument('--output-dir', default='output', help='Output directory for batch operations') io_group.add_argument('--output', '-o', help='Output filename')
parser.add_argument('--batch', metavar='FILE', help='Process URLs from file') io_group.add_argument('--output-dir', default='output', help='Output directory')
parser.add_argument('--compose', nargs='+', metavar='IMAGE', help='Images to compose') io_group.add_argument('--batch', metavar='FILE', help='Process URLs from file')
io_group.add_argument('--compose', nargs='+', metavar='IMAGE', help='Additional images')
# Screenshot options # Screenshot options
parser.add_argument('--mobile', action='store_true', help='Mobile viewport') screenshot_group = parser.add_argument_group('Screenshot Options')
parser.add_argument('--viewport-only', action='store_true', help='Capture viewport only') screenshot_group.add_argument('--mobile', action='store_true', help='Mobile viewport')
parser.add_argument('--wait', type=int, default=3, help='Wait time before screenshot (seconds)') screenshot_group.add_argument('--viewport-only', action='store_true', help='Viewport only')
screenshot_group.add_argument('--wait', type=int, default=3, help='Wait seconds before capture')
# Processing options # Processing options
parser.add_argument('--preserve-content', action='store_true', process_group = parser.add_argument_group('Processing Options')
help='Preserve original content in style transfer') process_group.add_argument('--preserve-content', action='store_true',
parser.add_argument('--save-intermediates', action='store_true', help='Preserve original layout')
help='Save intermediate refinement steps') process_group.add_argument('--save-intermediates', action='store_true',
parser.add_argument('--high-quality', action='store_true', default=True, help='Save refinement steps')
help='Generate maximum quality images (default: enabled)') process_group.add_argument('--high-quality', action='store_true', default=True,
parser.add_argument('--verbose', '-v', action='store_true', help='Verbose output') help='Maximum quality (default: on)')
process_group.add_argument('--verbose', '-v', action='store_true', help='Show details')
# API configuration # API configuration
parser.add_argument('--firecrawl-url', help='Custom Firecrawl API URL') api_group = parser.add_argument_group('API Configuration')
api_group.add_argument('--firecrawl-url', help='Custom Firecrawl endpoint')
args = parser.parse_args() args = parser.parse_args()