{"id":20837182,"url":"https://github.com/Surfer-Org/Protocol","last_synced_at":"2025-05-12T00:31:24.367Z","repository":{"id":259220430,"uuid":"876266855","full_name":"Surfer-Org/Old-Protocol","owner":"Surfer-Org","description":"This is the Surfer Protocol","archived":false,"fork":false,"pushed_at":"2024-11-05T01:39:08.000Z","size":11560,"stargazers_count":9,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-05-01T02:16:12.543Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://surferprotocol.org","language":"MDX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Surfer-Org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-21T17:18:09.000Z","updated_at":"2025-01-12T04:37:37.000Z","dependencies_parsed_at":"2024-11-15T00:26:47.366Z","dependency_job_id":"181805cb-0f03-4149-88df-8bb6ab377388","html_url":"https://github.com/Surfer-Org/Old-Protocol","commit_stats":null,"previous_names":["surfer-protocol/protocol","surfer-org/protocol"],"tags_count":3,"template":false,"template_full_name":"mintlify/starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Surfer-Org%2FOld-Protocol","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Surfer-Org%2FOld-Protocol/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Surfer-Org%2FOld-Protocol/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Surfer-Org%2FOld-Protocol/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Surfer-Org","download_url":"https://codeload.github.com/Surfer-Org/Old-Protocol/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253655844,"owners_count":21943069,"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":[],"created_at":"2024-11-18T01:01:17.822Z","updated_at":"2025-05-12T00:31:19.343Z","avatar_url":"https://github.com/Surfer-Org.png","language":"MDX","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# Surfer Protocol: An open-source framework for exporting and building applications off of your personal data\n\n\u003e ### ⚠️ Looking for the Surfer Desktop App or the Surfer Python SDK? \n\u003e Desktop App: [Surfer Desktop App](https://github.com/Surfer-Org/Desktop-App)\\\n\u003e SDK: [Surfer Python SDK](https://github.com/Surfer-Org/Python-SDK)\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n[![](https://dcbadge.vercel.app/api/server/5KQkWApkYC)](https://discord.gg/5KQkWApkYC)\n\n## What is Surfer Protocol?\n\nSurfer Protocol is an open-source framework for exporting and building applications off of your personal data.\n\nYour personal data is siloed across many platforms and apps. Big tech companies have no incentive to give you easy access to your own data. Whether you want to make an AI clone that texts like you, reclaim your data from big tech, or leave a digital legacy, Surfer Protocol is the way to do it.\n\nCurrently, Surfer Protocol consists of a Python SDK and a Desktop App. The Desktop App is used for exporting your data from your favorite apps and services. The Python SDK is used for building applications off of your personal data.\n\n## Features\n\n- Desktop App for exporting data from your favorite apps and services\n- Python SDK for building applications off of your personal data\n\n## How it works\n\n![Surfer Diagram](assets/SurferDiagram.png)\n\n1. Click on \"Export\" to initiate the data extraction process.\n2. The app waits for the target page to load completely.\n3. The system checks if the user is signed in to the platform being scraped.\n4. If not signed in, the user is prompted to sign in.\n5. If signed in, the process continues.\n6. Once signed in, the app interacts with the platform's user interface.\n7. The app then scrapes the user's data from the platform.\n8. Finally, the extracted data is exported and saved to your local storage.\n\n## Sample Exported Data\n\n```json{\n  \"platform_name\": \"X Corp\",\n  \"name\": \"Twitter\",\n  \"runID\": \"twitter-001-1724267514217\",\n  \"timestamp\": 1724267623318,\n  \"content\": [\n    \"Twitter Post 1\",\n    \"Twitter Post 2\",\n    \"Twitter Post 3\",\n    ...\n  ]\n}\n```\n\n## Getting Started\n\nTo download the app, head over to [https://surfsup.ai](https://surfsup.ai). Or you can go to the releases page.\n\nFor instructions on setting up the app locally and contributing to the project, please refer to the [Contributing Guidelines](CONTRIBUTING.md), [Helper Functions Documentation](docs/HELPER_FUNCTIONS.md), and [Guide to Adding New Platforms](docs/ADD_PLATFORMS.md).\n\nSee the [open issues](https://github.com/Surfer-Org/Desktop-App/issues) for a full list of proposed features (and known issues).\n\n## License\n\nDistributed under the MIT License. See [`LICENSE`](https://github.com/Surfer-Org/Desktop-App/blob/main/LICENSE) for more information.\n\n## Built With\n\n* [![Electron][Electron.js]][Electron-url]\n* [![React][React.js]][React-url]\n* [![Tailwind][Tailwind.css]][Tailwind-url]\n* [![Shadcn UI][Shadcn.ui]][Shadcn-url]\n\n## Contact\n\n[Surfer Discord Server](https://discord.gg/Tjg7pjcFNP) - [@SahilLalani0](https://x.com/SahilLalani0) - [@JackBlair87](https://x.com/JackBlair87) - [@T0M_3D](https://x.com/T0M_3D)\n\nProject Link: [https://github.com/Surfer-Org/Desktop-App](https://github.com/Surfer-Org/Desktop-App)\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=Surfer-Org/Desktop-App\u0026type=Date)](https://star-history.com/#Surfer-Org/Desktop-App\u0026Date)\n\n## Acknowledgements\n\n- [Electron React Boilerplate](https://github.com/electron-react-boilerplate/electron-react-boilerplate)\n\n[contributors-shield]: https://img.shields.io/github/contributors/Surfer-Org/Desktop-App.svg?style=for-the-badge\n[contributors-url]: https://github.com/Surfer-Org/Desktop-App/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/Surfer-Org/Desktop-App.svg?style=for-the-badge\n[forks-url]: https://github.com/Surfer-Org/Desktop-App/network/members\n[stars-shield]: https://img.shields.io/github/stars/Surfer-Org/Desktop-App.svg?style=for-the-badge\n[stars-url]: https://github.com/Surfer-Org/Desktop-App/stargazers\n[issues-shield]: https://img.shields.io/github/issues/Surfer-Org/Desktop-App.svg?style=for-the-badge\n[issues-url]: https://github.com/Surfer-Org/Desktop-App/issues\n[license-shield]: https://img.shields.io/github/license/Surfer-Org/Desktop-App.svg?style=for-the-badge\n[license-url]: https://github.com/Surfer-Org/Desktop-App/blob/master/LICENSE\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://linkedin.com/in/cerebrus-maximus\n[React.js]: https://img.shields.io/badge/React-20232A?style=for-the-badge\u0026logo=react\u0026logoColor=61DAFB\n[React-url]: https://reactjs.org/\n[Tailwind.css]: https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=for-the-badge\u0026logo=tailwind-css\u0026logoColor=white\n[Tailwind-url]: https://tailwindcss.com/\n[Electron.js]: https://img.shields.io/badge/Electron-2B2E3A?style=for-the-badge\u0026logo=electron\u0026logoColor=9FEAF9\n[Electron-url]: https://www.electronjs.org/\n[Shadcn.ui]: https://img.shields.io/badge/Shadcn_UI-F05032?style=for-the-badge\u0026logo=shadcn\u0026logoColor=white\n[Shadcn-url]: https://ui.shadcn.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSurfer-Org%2FProtocol","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSurfer-Org%2FProtocol","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSurfer-Org%2FProtocol/lists"}