{"id":22188565,"url":"https://github.com/reyemb/aisexplorer","last_synced_at":"2026-01-14T09:59:57.581Z","repository":{"id":57409370,"uuid":"430212213","full_name":"reyemb/AISExplorer","owner":"reyemb","description":"This tool allows the identification and tracking of marine vessels by geolocation, MMSI, or via MarineTraffic URLs. It ensures user privacy via proxy support, and includes fallback strategies for optimal performance.","archived":false,"fork":false,"pushed_at":"2023-12-19T19:58:47.000Z","size":237,"stargazers_count":27,"open_issues_count":1,"forks_count":8,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-11-06T04:20:11.692Z","etag":null,"topics":["ais","ais-data","marine-data","proxy","ship-tracking","vessel","vessel-detection","vessel-trackimg"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/reyemb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-11-20T21:24:03.000Z","updated_at":"2024-06-04T01:17:09.000Z","dependencies_parsed_at":"2024-01-13T11:57:10.298Z","dependency_job_id":"21aa38ab-b9a8-4dbb-8357-d9d6f4410c0e","html_url":"https://github.com/reyemb/AISExplorer","commit_stats":{"total_commits":35,"total_committers":2,"mean_commits":17.5,"dds":0.08571428571428574,"last_synced_commit":"89296f7a4e3710bd197585cd28736e82872a9b10"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reyemb%2FAISExplorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reyemb%2FAISExplorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reyemb%2FAISExplorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reyemb%2FAISExplorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/reyemb","download_url":"https://codeload.github.com/reyemb/AISExplorer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227715610,"owners_count":17808734,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ais","ais-data","marine-data","proxy","ship-tracking","vessel","vessel-detection","vessel-trackimg"],"created_at":"2024-12-02T11:11:33.089Z","updated_at":"2026-01-14T09:59:57.523Z","avatar_url":"https://github.com/reyemb.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AISExplorer  \n\n![PyPI](https://img.shields.io/pypi/v/AISExplorer)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/AISExplorer)\n\nAISExplorer is a tool for locating vessels or scraping vessel data in a specific area. However, due to recent updates, the use of free proxies, previously scraped from sources like [sslproxies](https://www.sslproxies.org/), has been discontinued due to errors such as 403 Forbidden responses.\n\n## Next Steps\n\n- Explore additional sources for proxy lists.\n- Implement a method to customize the number of retries.\n- Introduce functionality to reset filters.\n\n## Changelog\n\n### 2023-11-10\n\n  - Due to Captcha implementation, login functionality is broken.\n  - Sending requests through proxies now leads to a 403 error; proxy support has been removed.\n\n### 2023-1-21\n\n- Integrated login functions for additional features.\n\n### 2021-12-10\n\n- Implemented fallback if a proxy fails.\n- Introduced the ability to retrieve data directly via URL.\n- Added checks for Cloudflare's filtering mechanisms.\n\n### 2021-12-5\n\n- Early stages of filter implementation.\n- Retry options were added for resilience.\n- New exceptions were introduced for better error handling.\n\n### 2021-11-27\n\n- Proxy support was added (discontinued as of 2023-11-10).\n\n## Installation\n\n``` cmd\npip install aisexplorer\n```\n\n## Usage\n\n### Find vessel by MMIS\nRetrieve the current location of a vessel using its MMSI identifier.\n\n```python\nfrom aisexplorer.AIS import AIS\n\nAIS().get_location(211281610)\n```\n\n### Find vessels in Area\nRetrieve data for up to 500 vessels within a designated area.\n\n**maximum 500 vessels**\n\n```python\nfrom aisexplorer.AIS import AIS\n\nAIS(return_df= True).get_area_data(\"EMED\")\n```\n\nThe output is limited to 500 rows. Area codes can be referenced from the MarineTraffic help section.\n[Areas](https://help.marinetraffic.com/hc/en-us/articles/214556408-Areas-of-the-World-How-does-MarineTraffic-segment-them-) can be found here\n\n### Get Table via URL\nDirectly access table data using a MarineTraffic URL.\n\n```python\nfrom aisexplorer.AIS import AIS\n\nAIS(return_df = True).get_data_by_url(\"https://www.marinetraffic.com/en/data/?asset_type=vessels\u0026columns=time_of_latest_position:desc,flag,shipname,photo,recognized_next_port,reported_eta,reported_destination,current_port,imo,ship_type,show_on_live_map,area,lat_of_latest_position,lon_of_latest_position,speed,length,width\u0026area_in|in|West%20Mediterranean,East%20Mediterranean|area_in=WMED,EMED\u0026time_of_latest_position_between|gte|time_of_latest_position_between=60,NaN\")\n```\n\n### Use Proxies\n\nPreviously, AISExplorer allowed fetching data using proxies for anonymization. This feature is no longer supported due to compatibility issues with the data source.\n\n### Get Data for user created fleets\n\nNo longer available as it required user login, which is now deprecated due to captcha implementation.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freyemb%2Faisexplorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freyemb%2Faisexplorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freyemb%2Faisexplorer/lists"}