What is peddler?

Peddler is a Ruby library that lets you programmatically connect to Amazon's seller tools. If you run a business selling on Amazon, Peddler lets your code talk directly to Amazon's systems to check orders, manage inventory, upload product listings, request reports, handle payments, and more, without having to log into Amazon's website manually each time. Think of it like a translator. Amazon provides a complex set of web services (called MWS, or Marketplace Web Service) that speak a specific technical language. Peddler wraps all that complexity into simple Ruby commands. Instead of writing hundreds of lines of low-level code to fetch your orders, you can just call a method like client.list_orders and get back structured data you can work with. To use Peddler, you set up a client, roughly one for each type of task you want to do. You might create one for orders, another for inventory, another for financial data. You give the client your Amazon credentials (Marketplace ID, Merchant ID, AWS keys), and then you're ready to make requests. When Amazon responds, Peddler automatically parses the response into a format your Ruby code can easily read and use. The library also handles errors gracefully, so if Amazon is temporarily unavailable or you hit rate limits, you can set up custom error handling to retry or log what happened. The library covers nearly all of Amazon's seller APIs, Orders, Products, Reports, Feeds, Inventory, Fulfillment, Finances, Recommendations, and more. A small business might use it to sync their inventory from their own database into Amazon, or a larger seller might use it to automatically generate reports and track payments. Anyone building a tool or dashboard for Amazon sellers would use this library as the foundation.