Owl Browser
DocsFTP Clientftp_list

ftp_list

Ftp List

List the contents of an FTP directory. Returns the directory listing as text. Supports authenticated FTP, FTPS (FTP over SSL/TLS), proxy configuration, and Tor anonymization. The URL must end with a trailing slash for directory listings.

Usage Example

1234567891011
import asyncio
from owl_browser import OwlBrowser, RemoteConfig
# Async usage
async with OwlBrowser(config) as browser:
context = await browser.create_context()
context_id = context["context_id"]
await browser.ftp_list(
url="https://example.com"
)

Parameters

Required

urlstringrequired

FTP URL to list (e.g., 'ftp://ftp.example.com/pub/'). Must end with / for directory listing.

Optional

usernamestring

FTP username. Default: anonymous

passwordstring

FTP password. Default: empty

proxy_typeenum
httphttpssocks4socks5+1 more

Type of proxy server.

proxy_hoststring

Proxy server hostname or IP address.

proxy_portstring

Proxy server port number.

proxy_usernamestring

Username for proxy authentication.

proxy_passwordstring

Password for proxy authentication.

use_torboolean

Use built-in Tor proxy. Default: false

timeoutstring

Timeout in milliseconds. Default: 30000

use_sslboolean

Use FTPS (FTP over SSL/TLS). Default: false

Response

Returns a JSON object with the operation result.

{
  "success": true,
  "result": <value>
}