SEOmoz Mozscape Add-In For Excel

With the updates just added to the Mozscape API (previously Linkscape), I decided to update the Excel Macro and turn it into a full-fledged Excel Add-In.

Features:
Select any number of cells containing URL’s.
Right-click and select “Run Mozscape on Selection”
Enter your Access ID and Secret Key (aka Private Key) from the api page.
http://www.seomoz.org/api/keys
A big improvement is that you only need to do this once. ๐Ÿ™‚
Mozscape API Credentials
If your credentials are accepted, a new sheet named “Mozscape” will be created and all url-metrics will be added for your chosen URL’s.

Warnings:
If you run this twice, or if you already have a sheet named “Mozscape” it will be deleted and replaced. Rename it before running again if you want to keep the data.
The free Mozscape API is limited to 1 request every 10 seconds.
100 URL’s would take about 17 minutes. 1,000 would take 3 hours.

Full details will be posted soon. For now, I’m just looking for a few beta testers. ***Please bear with me as this is very much a draft version. There are many features I intend to add, but since the latest release of the Mozscape API broke our previous macro, I’m releasing this untested in case anyone really needs the data. Your support and patience is very much appreciated.

[Update 9/8/2012 : If you’re not seeing any data, it’s because of a change to the Mozscape API code. They now require that we explicitly list which url-metrics we want to return by using bit flags. I’m expecting to release a new version today that will fix this as well as a few of the other bugs we’ve seen. More info here: http://apiwiki.seomoz.org/deprecated#default-metrics ]

[Update 9/10/2012 : We’ve updated the code to use bit flags, fixing the previous issue. Individual bit flag selection has been added as a todo item, as it’s best to only retrieve the minimum amount of information you need.
Automatically trims access id and secret key to remove extra spaces.
Installs prerequisite software, such as .NET 4.0 and VSTO Runtime. ]

*** Download the latest version here. ***
[[ This version has only been verified to work with Excel 2010 on a computer running Windows 7. If you get it to work on any other setup, please let us know. ]]
Mozscape Add-in : Beta 1 (9/4/2012)
MozscapeAdd-in : Beta 2 (9/10/2012)
MozscapeAdd-in : Beta 2.2 (9/10/2012)
MozscapeAdd-in : Beta 2.3 (9/11/2012)
*****************************************

Please post any questions or suggestions in the comments below. To receive a notice of each release, enter your name and email in the box below. Thanks again for your support!


Posted

in

by

Comments

38 responses to “SEOmoz Mozscape Add-In For Excel”

  1. […] September 22, 2011 · 15 comments I’m very happy to announce an updated version of our Excel Interface to the seoMoz LinkScape / Mozscape API. Your suggestions have been heeded and the new version is a great improvement over the […]

  2. […] beta) Rather than a vba macro, this new version is an installable Excel Add-in. Check it out here: http://www.businesshut.com/seo/seomoz-mozscape-add-in-for-excel/ This also renders most of the instructions on THIS page, null and void. The new page above will […]

  3. Aron Avatar
    Aron

    Hi,

    It works for me now, there was a space at the end of the secret key that was causing a problem:) I was wondering if there is a way to adjust the timing between calls to be just over 5 seconds. In your other program, I had adjusted the “sleep” command. The time between calls for someone that has an account with seomoz is 5 seconds, instead of 10 seconds.

    Thanks

    1. Jason Green Avatar

      Excellent! We had that problem with the extra spaces on the macro version too. Glad you found the problem and thank you so much for sticking with it. I think I’ll add a trim function to those fields to prevent this from happening again.

      As for the rate limiting, yes, I’m aware that paid moz members get a faster limit. It’s just a matter of changing the sleep function from 10 down to 5 seconds. I’m working on a way to have this be user-configurable. For anyone paying the $500 for full API access, they can get up to 200 requests per second!

      Since you’ve been so helpful, I’ll see if I can publish a new version with a 5-second rate limit just for my VIP beta testers. ๐Ÿ™‚

  4. Jeremy Avatar
    Jeremy

    Hello,

    Just gave this a try and it doesn’t pull any data. Installs fine and accepts my credentials.

    Thanks for the great tool!

    1. Jason Green Avatar

      Jeremy, Thanks for posting. I’m actually having the same problem as well. I’m checking out the code now and will post an update asap. Please subscribe to the update list, or check back often for the new version.

      1. Jeremy Avatar
        Jeremy

        Thanks! Will do.

        I’ve been playing around with a couple other tool that use SEOMoz data and they don’t work either so maybe it is something on their end. I know they were down yesterday.

        It’s weird though, if I make direct queries through my API I get data back but when trying to use tools designed to pull the data no luck.

  5. David Avatar

    I ran setup, rebooted as needed, launched Excel 2010, but the following message popped up:

    The following microsoft office solution cannot be loaded because a compatible version of the .NET Framework is not installed: MozscapeAddin.vsto. For more information see (and there’s a URL to a page on go.microsoft.com)

    I can see the .vsto file in the unzipped folder.

    Also, I figured I’d run setup again, but the exact same message popped up.

    David

    1. Jason Green Avatar

      Thanks David. I’ll be republishing this weekend with the VSTO / .NET code built into the setup process. Sorry for the inconvenience, and thanks for helping work out the bugs.

      1. David Avatar

        Hey Jason, just downloaded, ran setup, rebooted; setup continued after reboot then I got the exact same error message I reported above (boo!). I’m using Excel 2010 version 14.0.6123.5001 32-bit, if that’s helpful to know.

        David

        1. Jason Green Avatar

          Thanks for trying again David. I think I got it now. It had the VSTO runtime, but was missing the Primary Interop Assemblies. That should be the last thing we’re missing. (Unfortunately, this is difficult for me to replicate because all of my PC’s are setup for development.) I really appreciate your feedback and patience while I work out these bugs.

          1. David Avatar

            Hey Jason – I downloaded the 2.2 version, unzipped and ran the setup file and got the same error message, this time right after the setup initialized. Looking forward to 2.3? ๐Ÿ™‚

          2. Jason Green Avatar

            David. I was able to replicate the error on a Win 7 pc with Excel 2010. Working on which version of the .NET framework I need it to install. Could be a day of installing/uninstalling ahead of me. I’ll refrain from publishing new versions until I’m sure it will work for you. 2.3 will be the one. ๐Ÿ™‚

          3. David Avatar

            Thank you Jason, I’m looking forward to version 2.3 – I forgot to mention I’m running Windows XP, if that’s helpful.

            David

          4. Jason Green Avatar

            David. Beta 2.3 has arrived!
            I updated the type of .NET package it installed and got it to work on the Windows 7 PC. (Installed and verified by my wife.) If you still get the error, it’ll have to be because of XP, but let’s keep those fingers crossed that it just works. ๐Ÿ™‚

      2. David Avatar

        Hey Jason, I downloaded, unzipped, ran setup which ran this time then provided a new error message different than previous (let me know if you want me to email a screenshot) that says

        Microsoft Office Customization Installer
        Installing Office customization
        Name: MozscapeAddin
        From: (path on my computer to the .vsto file)
        (red circle with X and this message): Customized functionality in this application will not work because the certificate used to sign the deployment manifest for MozscapteAddin or its location is not trusted. Contact your administrator for further assistance.

        Note that I’m not on a network or shared environment. Pllleeaaase let this not be an XP thing, I really want to use this plugin (as you can tell! ๐Ÿ™‚ )

        Thanks for your updates! Hopefully this is an easy fix? Fingers crossed…

        David

        1. Jason Green Avatar

          Progress. ๐Ÿ™‚
          Go to your Excel Options under “File”.
          Choose “Trust Center”.
          Click the “Trust Center Settings” button.
          Choose “Add-ins”.
          There should be a check box for “Require Application Add-ins to be signed by Trusted Publisher”.
          Uncheck that box and click ok, ok.
          Close Excel.
          Try to install again.

          If all goes well, that should be the last error! Fingers crossed again. ๐Ÿ™‚

          1. David Avatar

            Love progress!

            I went there and that box was already unchecked. I tried setup again just because; fail. Tried checking the box; fail – unchecked again; fail again (I did close Excel each time for running setup again).

            So then I examined the last part of the error message “or it’s location may not be trusted” so I added the path to my downloaded unizipped beta2-3 file location, and that failed. Then I examined the existing file locations and put the unzipped file into one of those locations (one I found said “addins”) but that also failed.

            I’m willing to keep trying! ๐Ÿ™‚ Any other suggestions? (please please please!)

            Thanks!
            David

          2. David Avatar

            PS: here’s the error details, hopefully helpful – many fingers crossed! ๐Ÿ™‚

            Name: MozscapeAddin
            From: file:///C:/DOWNLOAD/MozscapeAdd-in_20120911_Beta2-3/MozscapeAddin.vsto

            ************** Exception Text **************
            System.Security.SecurityException: Customized functionality in this application will not work because the certificate used to sign the deployment manifest for MozscapeAddin or its location is not trusted. Contact your administrator for further assistance.
            at Microsoft.VisualStudio.Tools.Applications.Deployment.ClickOnceAddInTrustEvaluator.VerifyTrustPromptKeyInternal(ClickOnceTrustPromptKeyValue promptKeyValue, DeploymentSignatureInformation signatureInformation, String productName)
            at Microsoft.VisualStudio.Tools.Applications.Deployment.ClickOnceAddInTrustEvaluator.VerifyTrustUsingPromptKey(Uri manifest, DeploymentSignatureInformation signatureInformation, String productName)
            at Microsoft.VisualStudio.Tools.Applications.Deployment.ClickOnceAddInDeploymentManager.VerifySecurity(ActivationContext context, Uri manifest, AddInInstallationStatus installState)
            at Microsoft.VisualStudio.Tools.Applications.Deployment.ClickOnceAddInDeploymentManager.InstallAddIn()
            The Zone of the assembly that failed was:
            MyComputer

          3. Jason Green Avatar

            David, I found a possible solution, but for now, we’ll refer to it as a hack. ๐Ÿ™‚
            http://msdn.microsoft.com/en-us/library/bb772070.aspx

            If you’re comfortable editing registry values, you can follow the instructions int the post above. Otherwise, I’ll build a small console application that will update the values programmatically. This would still be considered a hack until I can figure out how to implement this into the installer and/or buy a digital certificate.

            ***I leave for vacation tomorrow, so let’s hope this works!***

          4. David Avatar

            Hey Jason – I’ll review info at that link and see if it’s over my head or not – I’m going on vacation this Saturday to the following week (back in office on 24th) so if you’re out a week too, that’s a good match, eh? – have a fun vacation!

            David

          5. David Avatar

            Me again. ๐Ÿ™‚ Tried the hack, pretty sure I did it correctly, rebooted, ran setup, same error message.

            I’ve come too far to give up! ๐Ÿ™‚ – I’m on the email update list and would love to install so please feel free to email me and/or I’ll keep watch on this page, eh?

            Thanks for all your time (and hand-holding) looking forward to using this obviously-great tool!

            David

          6. David Avatar

            Hey Jason, just realized I forgot to check back here after my vacation a couple weeks ago – is there an updated version I should be trying?

            Thanks!
            David

  6. Jason Green Avatar

    Beta 2 has been published.
    Utilizes bit flags.
    Trims access ID and secret key to remove spaces.
    Installs prerequisite software. (.NET 4.0 and VSTO Runtime)

    Please download the latest version and let us know how it goes.

    Thank you,

    Jason Green

  7. Roel B. Avatar
    Roel B.

    The newest add-in also seems to work on Excel 2007, but only for a small selection. When I select more than 10 URL’s, the add-in returns a prompt stating that a 503 server error response occurred.

    Do you think that this is due to the version of Excel?

    Anyways, I think you’re doing a great job and I think the tool kicks some serious butt.

    Best,

    Roel

    1. Jason Green Avatar

      Roel, That’s good to hear, and thanks for the encouragement! ๐Ÿ™‚

      I intend to publish a fully working solution for Excel 2007, but wanted to work out the major issues in one system first. We should be there pretty soon.

    2. David Portney Avatar
      David Portney

      Hey Roel,

      That worked! It installed just fine.

      And even better, IT’S WORKING!

      Thanks for your help, and big thanks to Jason for making this plugin!

      David

  8. Roel B. Avatar
    Roel B.

    For me, the add-in works better when running Excel 2007 rather than Excel 2010.

    When I try to install it on a machine running Excel 2010, I run into the same error messages as David.

    In Excel 2007, the add-in is stable when checking no more than 20 URL’s. I can only run the process once, when I want to check another batch of domains, I have to exit Excel (end the entire process).

  9. Roel B. Avatar
    Roel B.

    For me, the newest add-in works perfectly with a Windows7/Excel2007 combination. The only thing is that I can run it only once per process, so I have to restart EXCEL.EXE when I want to run another selection.

    Thanks again for an amazing tool!

  10. Charlotte Avatar

    Hi Jason,

    Thanks for the incredibly useful tool! I just have one suggestion – at the moment if the code can’t find one of the sites in a list it halts the whole thing with an error message. This makes it difficult to run long lists of sites, as I then have to reset and start again.

    If the code could mark the site as an error and then carry on down the list, that’d save tons of time!

    Many thanks,
    Charlotte.

  11. Aron Avatar
    Aron

    Hi Jason,

    Any word on the ability to change the sleep function to 5 seconds for your testers?:)

  12. Paul Avatar

    Wondering if anyone else has had this issue. Windows 7 with Excel 2010 and everything installs good, but when I right click there isn’t anything there to click on. Just the standard options appear. Any ideas?

    Thanks!

  13. Stephen Avatar
    Stephen

    I am trying to run the Add-In:

    Install was fine but when I right click and run “MozScape on Selection” nothing happens.

    Help is much appreciated. I have my Access ID and secret key ready for next step but there is no option for it.

  14. Roel Avatar
    Roel

    Hi David,

    Don’t know if you’re still looking for a solution, but I managed to install the plugin correctly. I experienced the same problems you describe, but I solved it by ‘unblocking’ the files.

    When you download the addin, unzip all files into a new directory. Then, one by one, rightclick on the files and go to ‘Properties’ and click the ‘Unblock’ button (see this image: http://hypftier.de/dump/properties_unblock.png).

    Do so for all the files, also in the Application Files directory. Then run the Setup file. Hope it works for you too!

  15. Olli Avatar
    Olli

    Hi there. Thanks so much for this. Only thing that was unclear is, that Excel loads the plugin from the unzipped folder every time – even though I ran setup. Maybe you can mention this in the readme.txt or a FAQ, since I would have put the folder initially into another location prior to installing it ๐Ÿ˜‰ Otherwise: It won’t request my API-and secret-stuff, sadly. Until I figured out why this is, I can’t give it a try. Greets, Olli

  16. Joe Avatar
    Joe

    Is this working for 2013?

  17. Tauseef Azhar Avatar
    Tauseef Azhar

    Doesn’t it work with Office 2013?

    1. Jason Green Avatar

      Tauseef, Unfortunately, I haven’t tested with Office 2013. It was only working with 2007 and 2010. If you (or anyone else) would like an update, please show your interest by adding a comment or signing up for the notification list. If I get a good response, I’ll certainly put in the time to get this updated.

Leave a Reply

Your email address will not be published. Required fields are marked *