Troubleshooting

Common Issues and Solutions

Configuration Problems

Config file not found

Error: Config file ~/.ai-marketplace-monitor/config.toml not found

Solution: - Ensure the config file exists at ~/.ai-marketplace-monitor/config.toml - Check file permissions (should be readable by your user) - Use --config flag to specify a different location

Invalid TOML syntax

Error: Invalid TOML configuration

Solution: - Validate your TOML syntax at toml-lint.com - Check for missing quotes around strings - Ensure proper section headers like [marketplace.facebook]

Login and Authentication Issues

Facebook login failure

Warning: Failed to login to Facebook

Solution: - Provide username/password in config file - Complete CAPTCHA challenges manually - The monitor will continue with limited results if login fails

Two-factor authentication required

Solution: - Complete 2FA manually in the browser window - Consider using app passwords where supported - Monitor will remember login state for future runs

Browser and Playwright Issues

Playwright browser not installed

Error: Browser executable not found

Solution:

$ playwright install

Browser crashes or hangs

Solution: - Restart the monitor - Try headless mode: ai-marketplace-monitor --headless - Check system resources (RAM, CPU)

Notification Problems

PushBullet notifications not received

Solutions: - Verify API token is correct - Check PushBullet app is installed and logged in - Test token at pushbullet.com

Email notifications failing

Solutions: - Check SMTP settings (server, port, username, password) - For Gmail, use app passwords instead of account password - Verify firewall/antivirus isn’t blocking SMTP

Telegram bot not responding

Solutions: - Verify bot token format: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 - Ensure you’ve started a conversation with the bot - Check chat ID is correct (positive for users, negative for groups)

AI Service Issues

OpenAI API errors

Error: OpenAI API request failed

Solutions: - Check API key is valid and has sufficient credits - Verify network connectivity - Review OpenAI status page for service issues

AI responses seem incorrect

Solutions: - Adjust AI prompts in configuration - Try different AI models (gpt-4, gpt-3.5-turbo, etc.) - Check if AI service has usage limits

Search and Filtering Problems

No listings found

Solutions: - Verify search city name is correct - Check price ranges aren’t too restrictive - Review keyword filters (keywords and antikeywords) - Test without AI filtering to see raw results

Too many irrelevant results

Solutions: - Add more specific keywords - Use antikeywords to exclude unwanted terms - Adjust AI rating threshold higher - Refine item descriptions for better AI filtering

Currency conversion issues

Solutions: - Check currency codes are valid (USD, EUR, GBP, etc.) - Ensure currency is specified for multi-region searches - Verify exchange rate data is available

Performance Issues

Monitor running slowly

Solutions: - Reduce search frequency in configuration - Clear cache: ai-marketplace-monitor --clear-cache all - Check system resources - Consider using fewer simultaneous searches

High CPU/memory usage

Solutions: - Use headless mode: --headless - Reduce number of concurrent browser tabs - Clear browser cache and data - Consider running on a more powerful machine

Language and Localization Issues

Non-English Facebook pages

Failed to get details of listing. The listing might not be in English.

Solutions: - Change Facebook language settings to English - Add language option to marketplace configuration - Define custom translation dictionary in config

Debug Mode and Logging

Enable verbose logging

Add to your configuration:

[monitor]
log_level = "DEBUG"

Check log files

Logs are typically saved to: - Console output (default) - Log files if configured in your system

Interactive debugging

  • Use option --check URL when starting ai-marketplace-monitor to test individual listings

  • Enter interactive mode by pressing any key while monitor is running. This feature requires the installation of pynput package.

Getting Help

If you’re still having issues:

  1. Check GitHub Issues: Search existing issues at github.com/BoPeng/ai-marketplace-monitor/issues

  2. Community Support: Join discussions at github.com/BoPeng/ai-marketplace-monitor/discussions

  3. Create New Issue: If you find a bug, create a detailed issue report including: - Your operating system - Python version - Complete error messages - Configuration file (remove sensitive data) - Steps to reproduce the problem

  4. Sponsor Support: Sponsors and donors receive priority email support - mention your sponsor status when contacting.

Reporting Bugs

When reporting bugs, please include:

**Environment:**
- OS: [e.g., Ubuntu 20.04, macOS 12.0, Windows 10]
- Python: [e.g., 3.10.2]
- ai-marketplace-monitor: [e.g., 0.9.6]

**Configuration:**
```toml
# Your config file with sensitive data removed
```

**Error Message:**
```
# Complete error message/traceback
```

**Steps to Reproduce:**
1. Step one
2. Step two
3. Step three

**Expected Behavior:**
What should have happened

**Actual Behavior:**
What actually happened