explore reads them once and makes actions you can call, with typed inputs and outputs. This page is the whole path.1orsel explore https://egeuysal.com/
123read_home / list_blog /blog returns titles, links, slugs read_blog_page /blog/{slug} takes slug
12orsel act egeuysal.com list_blog orsel act egeuysal.com read_blog_page --set slug=decay
act waits for the result. --set key=value is typed from the action (a slug of 2026 stays text, a limit of 5 is a number) and can be repeated; --input '{"slug":"decay"}' or piped JSON works too. Add --no-wait to get the run id back at once.slugs: pass one to the read action next to it.12345678import { Orsel } from 'orsel'; const orsel = new Orsel(); // ORSEL_KEY and ORSEL_URL const blog = await orsel.site('egeuysal.com', { explore: true }); const { slugs } = await blog.list_blog(); const post = await blog.read_blog_page({ slug: slugs[0] }); console.log(post.title);
12345from orsel import Orsel blog = Orsel().site("egeuysal.com", explore=True) post = blog.read_blog_page(slug=blog.list_blog()["slugs"][0]) print(post["title"])
ActionError with the run attached and the command that explains it (orsel explain <run id>). A missing input is named before anything is sent. explore: true makes the actions first when the site has none.1orsel typegen egeuysal.com --out src/egeuysal.ts
1234import type { EgeuysalComActions } from './egeuysal'; const blog = await orsel.site<EgeuysalComActions>('egeuysal.com'); blog.read_blog_page({ slug: 'decay' }); // input and output are typed
write, sensitive or irreversible) and waits for approval before anything is sent, as every write does. In code the call waits for a person to decide and throws ApprovalRequiredError if nobody does in time; approve it in the dashboard or with orsel approve <id>. A password is a secret, never an input.| You see | Because | Do |
has no actions yet | the site was not explored | orsel explore https://<site>/, or explore: true |
not made: … captcha | a person has to solve it | use the site yourself, or its own API |
not made: … drawn by JavaScript | the page is empty until a script runs | record it with orsel import (a HAR) |
ActionError … http_404 | the page moved | explore again; it replaces what it made |
rate_limited | too many explorations (10 an hour) | wait, or call the actions you already have |